Share via

3.1.4.1.34 ApiDeleteValue (Opnum 33)

  • Article

(Protocol Version 2) In response to the ApiDeleteValue request from the client, for a successful operation, the server MUST delete the named value from the cluster registry key that is specified by the hKey parameter in the client request.

The server MUST accept an ApiDeleteValue request only if its protocol server state is read/write, as specified in section 3.1.1.

 error_status_t ApiDeleteValue(
   [in] HKEY_RPC hKey,
   [in, string] const wchar_t * lpValueName
 );

hKey: The HKEY_RPC context handle for a key that was previously obtained by a call to ApiGetRootKey, ApiCreateKey, or ApiOpenKey.

lpValueName: The name of the value, as specified in [MS-RRP], to delete. If the value name is NULL or an empty string, the server MUST delete the data in the default value of the specified key, as specified in section 3.1.1.2.

Return Values: The method MUST return 0x00000000 (ERROR_SUCCESS) to indicate success.

For any other condition, the server MUST return a value that is not 0x00000000. The client MUST behave in one consistent, identical manner for all values that are not 0x00000000, except as specified in section 3.2.4.6.