Funzione ORDeleteKey

Elimina una sottochiave e i relativi valori da un hive del Registro di sistema offline.

Sintassi

DWORD ORDeleteKey(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpSubKey
);

Parametri

Handle [in]

Handle per una chiave del Registro di sistema aperta in un hive del Registro di sistema offline. Questo handle viene restituito dalla funzione ORCreateKey o OROpenKey .

lpSubKey [in, facoltativo]

Nome della chiave da eliminare. Deve essere una sottochiave della chiave che Handle identifica, ma non può avere sottochiave.

Se la sottochiave non esiste, la funzione restituisce ERROR_NOT_FOUND.

Se questo parametro è NULL, la funzione elimina la chiave specificata dal parametro Handle . Se la chiave specificata dal parametro Handle è la chiave radice dell'hive, la funzione restituisce ERROR_INVALID_PARAMETER.

I nomi delle chiavi non sono distinzione tra maiuscole e minuscole.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore diverso da zero definito in Winerror.h. È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per ottenere una descrizione generica dell'errore. I codici di errore possibili includono quanto segue:

• Se la sottochiave specificata non esiste, la funzione restituisce ERROR_FILE_NOT_FOUND.
• Se la sottochiave specificata è la chiave radice dell'hive del Registro di sistema, la funzione restituisce ERROR_INVALID_PARAMETER.
• Se la sottochiave specificata include sottochiave, la funzione restituisce ERROR_KEY_HAS_CHILDREN.

Commenti

Se esiste la chiave del Registro di sistema specificata, viene contrassegnata come eliminata. Una chiave eliminata non viene rimossa fino all'ultima chiusura dell'handle.

La chiave da eliminare non deve avere sottochiave. Per eliminare una chiave e tutte le relative sottochiavi, usare la funzione OREnumKey per enumerare le sottochiave ed eliminarle singolarmente.

Solo la funzione ORCloseKey può essere chiamata su una chiave eliminata; tutte le altre operazioni del Registro di sistema offline hanno esito negativo. Se la chiave eliminata è stata creata in modo esplicito chiamando ORCreateKey, le risorse associate alla chiave vengono rilasciate quando l'ultimo handle alla chiave eliminata viene chiuso.

Requisiti

Requisito	Valore
Componente ridistribuibile	Libreria del Registro di sistema offline di Windows versione 1.0 o successiva
Intestazione	Offreg.h
DLL	Offreg.dll

Vedi anche

ORCloseKey

ORCreateKey

OREnumKey

OROpenKey