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 |
|
| DLL |
|
Vedi anche