Skip to content

CeRegEnumKeyEx.md

Latest commit

 

History

History
83 lines (59 loc) · 2.18 KB

CeRegEnumKeyEx.md

File metadata and controls

83 lines (59 loc) · 2.18 KB

Home

Function name : CeRegEnumKeyEx

Group: Remote Application Programming (RAPI) - Library: rapi

This function enumerates subkeys of the specified open registry key.

Code examples:

Pocket PC: custom RAPI class for operating with the System Registry

Declaration:

LONG CeRegEnumKeyEx(
  HKEY hKey,
  DWORD dwIndex,
  LPWSTR lpName,
  LPDWORD lpcbName,
  LPDWORD lpReserved,
  LPWSTR lpClass,
  LPDWORD lpcbClass,
  PFILETIME lpftLastWriteTime
);

FoxPro declaration:

DECLARE INTEGER CeRegEnumKeyEx IN rapi;
	INTEGER   hKey,;
	INTEGER   dwIndex,;
	STRING  @ lpName,;
	INTEGER @ lpcbName,;
	INTEGER   lpReserved,;
	STRING  @ lpClass,;
	INTEGER @ lpcbClass,;
	INTEGER   lpftLastWriteTime

Parameters:

hKey [in] Handle to a currently open key or a predefined reserved handle value

dwIndex [in] Specifies the index of the subkey to retrieve. This parameter should be 0 for the first call to the CeRegEnumKeyEx function and then incremented for subsequent calls.

lpName [out] Pointer to a buffer that receives the name of the subkey, including the terminating null character.

lpcbName [in, out] Pointer to a variable that specifies the size, in characters, of the buffer specified by the lpName parameter.

lpReserved [in] Reserved; set to NULL.

lpClass [out] Pointer to a buffer that contains the class of the enumerated subkey when the function returns.

lpcbClass [in, out] Pointer to a variable that specifies the size, in characters, of the buffer specified by the lpClass parameter.

lpftLastWriteTime [in] Ignored; set to NULL.

Return value:

ERROR_SUCCESS (0) indicates success.

Comments:

To enumerate subkeys, an application should initially call the CeRegEnumKeyEx function with the dwIndex parameter set to 0. An application should then increment the dwIndex parameter and call CeRegEnumKeyEx until there are no more subkeys (until the function returns ERROR_NO_MORE_ITEMS).