hini (HINI) - input
HINI_PROFILE
pszApp (PSZ) - input
The name of the application for which the profile data is required.
The search performed on the application name is always case-dependent. Names starting with the characters "PM_" are reserved for system use.
If this parameter is NULL, this function enumerates all the application names present in the profile and returns the names as a list in the pBuffer parameter. Each application name is terminated with a NULL character and the last name is terminated with two successive NULL characters. In this instance, the ulLength parameter contains the total length of the list excluding the final NULL character.
pszKey (PSZ) - input
The name of the key for which the profile data is returned.
The search on key name is always case-dependent.
If this parameter equals NULL, and if the pszApp parameter is not equal to NULL, this function enumerates all key names associated with the named application and returns the key names (not their values) as a list in the pBuffer parameter. Each key name is terminated with a NULL character and the last name is terminated with two successive NULL characters. In this instance, the ulLength parameter contains the total length of the list excluding the final NULL character.
pszDefault (PSZ) - input
The string that is returned in the pBuffer parameter, if the key defined by the pszKey parameter cannot be found in the profile.
If the pointer to this parameter is passed as NULL, then nothing is copied into the pszKey parameter if the key cannot be found. ulLength is returned as 0 in this case.
pBuffer (PVOID) - output
The text string obtained from the profile for the key defined by the pszKey parameter.
ulBufferMax (ULONG) - input
The maximum number of characters that can be put into the pBuffer parameter, in bytes. If the data from the profile is longer than this, it is truncated.
ulLength (ULONG) - returns
The actual number of characters (including the null termination character) returned in the pBuffer parameter, in bytes.