FONCTION ORGetKeySecurity

Récupère une copie du descripteur de sécurité protégeant la clé de Registre ouverte spécifiée dans une ruche de Registre hors connexion.

Syntaxe

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

Paramètres

Gérer [in]

Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.

SecurityInformation [in]

Valeur SECURITY_INFORMATION qui indique les informations de sécurité demandées.

pSecurityDescriptor [out, facultatif]

Pointeur vers une mémoire tampon qui reçoit une copie du descripteur de sécurité demandé. Ce paramètre peut être NULL.

lpcbSecurityDescriptor [in, out]

Pointeur vers une variable qui spécifie la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre pSecurityDescriptor . Lorsque la fonction retourne, la variable contient le nombre d’octets écrits dans la mémoire tampon.

Valeur retournée

Si la fonction réussit, la fonction retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.

Si la mémoire tampon spécifiée par le paramètre pSecurityDescriptor est trop petite, la fonction retourne ERROR_INSUFFICIENT_BUFFER et le paramètre lpcbSecurityDescriptor contient le nombre d’octets requis pour le descripteur de sécurité demandé.

Spécifications

Voir aussi

ORDeleteKey

OROpenKey

ORSetKeySecurity

SECURITY_INFORMATION