Funzione OROpenKey

Apre la chiave del Registro di sistema specificata in un hive del Registro di sistema offline.

Sintassi

DWORD OROpenKey(
  _In_     ORHKEY  Handle,
  _In_opt_ PCWSTR  lpSubKeyName,
  _Out_    PORHKEY phkResult
);

Parametri

Handle [in]

Handle per una chiave del Registro di sistema aperta in un hive del Registro di sistema offline.

lpSubKeyName [in, facoltativo]

Puntatore a una stringa UNICODE contenente il nome della chiave del Registro di sistema da aprire. Questa chiave deve essere una sottochiave della chiave identificata dal parametro Handle .

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

Se questo parametro è NULL o un puntatore a una stringa vuota, la funzione restituisce lo stesso handle passato. Se la chiave specificata dal parametro Handle è la chiave radice dell'hive, la funzione restituisce ERROR_INVALID_PARAMETER.

Per altre informazioni, vedere Limiti delle dimensioni degli elementi del Registro di sistema.

phkResult [out]

Puntatore a una variabile che riceve un handle per la chiave aperta. Usare la funzione ORCloseKey per chiudere la chiave al termine dell'uso dell'handle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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.

Se l'handle da restituire sarebbe un handle per la chiave radice dell'hive, la funzione restituisce ERROR_INVALID_PARAMETER.

Se la chiave specificata è stata contrassegnata come eliminata, questa funzione restituisce ERROR_KEY_DELETED.

Commenti

Non è possibile usare la funzione OROpenKey per aprire la chiave radice in un hive del Registro di sistema offline. Per ottenere un handle per la chiave radice di un hive, usare la funzione OROpenHive per caricare l'hive in memoria.

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

ORDeleteKey

OROpenHive