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
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Bibliothèque du Registre hors connexion Windows version 1.0 ou ultérieure |
| En-tête |
|
| DLL |
|
Voir aussi