_RegCreateDynKey

VMMREGRET _RegCreateDynKey (PCHAR lpszSubKey, PVOID pvKeyContext, 
      PPROVIDER pprovHandlerInfo, PPVALUE ppvalueValueInfo, 
      DWORD cpvalueValueInfo, PVMMHKEY phkResult);
 

Creates a dynamic key. It is defined in VXDWRAPS.H. This function makes copies of pprovKeyHandlerInfo and ppvalueValueInfo.

• Returns ERROR_SUCCESS if the function succeeds; otherwise returns one of the error values which can be returned by RegCreateKeyEx. In addition if the key already exists the function will return ERROR_REGISTRY_CANNOT_CREATE.

lpszSubKey

Pointer to the name of key to be created. The name is relative to HKEY_DYN_DATA. For example, suppose the new dynamic key will be HKEY_DYN_DATA\Keyname1\Keyname2. Then lpszSubKey="Keyname1\\Keyname2". The registry will create Keyname1 if it does not exist, and Keyname2. The provider will only be queried for values under the lowest level key (Keyname2).

pvKeyContext

The key context. This is a 32-bit value that is only meaningful to the provider. It is only necessary when the same provider is handling multiple dynamic keys. If the provider is only going to handle one dynamic key, then this parameter can be NULL.

pprovHandlerInfo

A pointer to a provider_info structure.

ppvalueValueInfo

An array of Pvalue structures. There must be one structure for each value under the dynamic key to be created.

cpvalueValueInfo

The number of structures in the ppvalueValueInfo array, which is equal to the number of values under this dynamic key.

phkResult

Pointer in which the function will return the open handle of the newly created dynamic key.