Jump to content

PrfQueryProgramHandle: Difference between revisions

From EDM2
Created page with "This function is used to obtain a handle for the requested executable file. ==Syntax== PrfQueryProgramHandle (HINI hini, PCSZ pszExe, PHPROGARRAY phprogArray, ULONG cchBuff..."
 
No edit summary
Line 22: Line 22:
==Returns==
==Returns==
Returns a program handle (ULONG).  
Returns a program handle (ULONG).  
==Remarks==
Gets a list of the program handles associated with a given executable file name. This tells a caller if, and where, a given executable file is referenced in the program list.
The entries for the installed program list are kept in the OS2.INI file. They can therefore be accessed using the installation file function calls.


[[Category:Prf]]
[[Category:Prf]]

Revision as of 05:22, 17 November 2023

This function is used to obtain a handle for the requested executable file.

Syntax

PrfQueryProgramHandle (HINI hini, PCSZ pszExe, PHPROGARRAY phprogArray, ULONG cchBufferMax, PULONG pulCount); 

Parameters

HINI
The initialization file handle
PSZ
Pointer to the executable file name string
PHPROGARRAY
Pointer to array to receive program handles
ULONG
The size of handles array
PULONG
The address at which to store the handles returned count

Returns

Returns a program handle (ULONG).

Remarks

Gets a list of the program handles associated with a given executable file name. This tells a caller if, and where, a given executable file is referenced in the program list.

The entries for the installed program list are kept in the OS2.INI file. They can therefore be accessed using the installation file function calls.