FUNZIONE ORGetKeySecurity

Recupera una copia del descrittore di sicurezza che protegge la chiave del Registro di sistema aperta specificata in un hive del Registro di sistema offline.

Sintassi

DWORD ORGetKeySecurity(
  _In_      ORHKEY               Handle,
  _In_      SECURITY_INFORMATION SecurityInformation,
  _Out_opt_ PSECURITY_DESCRIPTOR pSecurityDescriptor,
  _Inout_   PDWORD               lpcbSecurityDescriptor
);

Parametri

Handle [in]

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

SecurityInformation [in]

Valore SECURITY_INFORMATION che indica le informazioni di sicurezza richieste.

pSecurityDescriptor [out, optional]

Puntatore a un buffer che riceve una copia del descrittore di sicurezza richiesto. Questo parametro può essere NULL.

lpcbSecurityDescriptor [in, out]

Puntatore a una variabile che specifica le dimensioni, in byte, del buffer a cui punta il parametro pSecurityDescriptor . Quando la funzione viene restituita, la variabile contiene il numero di byte scritti nel buffer.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce 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 il buffer specificato dal parametro pSecurityDescriptor è troppo piccolo, la funzione restituisce ERROR_INSUFFICIENT_BUFFER e il parametro lpcbSecurityDescriptor contiene il numero di byte necessari per il descrittore di sicurezza richiesto.

Requisiti

Vedi anche

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION