PrfQueryProgramHandle: Difference between revisions
No edit summary |
No edit summary |
||
| Line 5: | Line 5: | ||
==Parameters== | ==Parameters== | ||
;HINI | ;HINI ''hini'' (input) | ||
:The initialization file handle | :The initialization file handle | ||
;PSZ | ;PSZ ''pszExe'' (input) | ||
:Pointer to the executable file name string | :Pointer to the executable file name string | ||
;PHPROGARRAY | ;PHPROGARRAY ''phprogArray'' (input) | ||
:Pointer to array to receive program handles | :Pointer to array to receive program handles | ||
;ULONG | ;ULONG ''cchBufferMax'' (input) | ||
:The size of handles array | :The size of handles array | ||
;PULONG | ;PULONG ''pulCount'' (input) | ||
:The address at which to store the handles returned count | :The address at which to store the handles returned count | ||
==Returns== | ==Returns== | ||
Returns a program handle | ;ULONG (return) | ||
Returns a program handle. | |||
==Remarks== | ==Remarks== | ||
Revision as of 21:24, 21 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 hini (input)
- The initialization file handle
- PSZ pszExe (input)
- Pointer to the executable file name string
- PHPROGARRAY phprogArray (input)
- Pointer to array to receive program handles
- ULONG cchBufferMax (input)
- The size of handles array
- PULONG pulCount (input)
- The address at which to store the handles returned count
Returns
- ULONG (return)
Returns a program handle.
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.