Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
CRegKey::EnumKey

CRegKey::EnumKey

Call this method to enumerate the subkeys of the open registry key.

LONG EnumKey(
   DWORD iIndex,
   LPTSTR pszName,
   LPDWORD pnNameLength,
   FILETIME* pftLastWriteTime = NULL 
) throw( );

Parameters

iIndex
The subkey index. This parameter should be zero for the first call and then incremented for subsequent calls
pszName
Pointer to a buffer that receives the name of the subkey, including the terminating null character. Only the name of the subkey is copied to the buffer, not the full key hierarchy.
pnNameLength
Pointer to a variable that specifies the size, in TCHARs, of the buffer specified by the pszName parameter. This size should include the terminating null character. When the method returns, the variable pointed to by pnNameLength contains the number of characters stored in the buffer. The count returned does not include the terminating null character.
pftLastWriteTime
Pointer to a variable that receives the time the enumerated subkey was last written to.

Return Value

If the method succeeds, the return value is ERROR_SUCCESS. If the method fails, the return value is a nonzero error code defined in WINERROR.H.

Remarks

To enumerate the subkeys, call CRegKey::EnumKey with an index of zero. Increment the index value and repeat until the method returns ERROR_NO_MORE_ITEMS. For more information, see RegEnumKeyEx in the Platform SDK.

See Also

CRegKey Overview | Class Members

Show:
© 2015 Microsoft