ISpDataKey::EnumKeys
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method enumerates the subkeys of the specified token.
Syntax
HRESULT EnumKeys(
ULONG Index,
WCHAR** ppszSubKeyName
);
Parameters
- Index
[in] Value indicating the token to locate in the enumeration sequence.
- ppszSubKeyName
[out] Address of a pointer to a null-terminated string specifying the name of the enumerated key. The associated object must be freed with CoTaskMemFree when no longer required.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
ppszSubKeyName is invalid or bad. |
SPERR_NOT_FOUND |
Registry key not found. |
E_OUTOFMEMORY |
Not enough memory to allocate string. |
SPERR_NO_MORE_ITEMS |
No items could be accessed. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |