_RegCreateDynKey

include vmm.h

RegCreateDynKey(LPSTR lpszName, LPVOID KeyContext, PPROVIDER pInfo,
    PPVALUE pValList, DWORD dwNumVals, HKEY FAR * pKeyHandle);
 

Creates the specified registry key under HKEY_DYN_DATA. Values under HKEY_DYN_DATA are maintained by the VxDs that create them. The VMM will call the appropriate VxD's enumeration entry point when a value is enumerated or queried.

• Returns ERROR_SUCCESS if the function succeeds. Otherwise, an error code is returned, possibly one of the following:

lpszName

Name of the key to create:

KeyContext

Four bytes of context that will be passed to the owning VxD when its enumeration entry point is called.

pInfo

Address of a PROVIDER structure (see vmmreg.h) that specifies the enumeration entry points for a key.

pValList

Address of an array of PVALUE structures (see vmmreg.h) that specify the value names and other attributes for the values under lpszName.

dwNumVals

Number of PVALUE structures in the pValList array.

pKeyHandle

Address of the variable to receive the handle of the newly created key, lpszName.