Fonction NCryptQueryProtectionDescriptorName (ncryptprotect.h)

Article
03/04/2024

La fonction NCryptQueryProtectionDescriptorName récupère la chaîne de règle de descripteur de protection associée à un nom d’affichage de descripteur inscrit.

Syntaxe

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

Paramètres

[in] pwszName

Nom d’affichage inscrit pour le descripteur de protection. Inscrivez un nom en appelant la fonction NCryptRegisterProtectionDescriptorName .

[out] pwszDescriptorString

Chaîne Unicode terminée par null qui contient la règle de descripteur de protection. Définissez cette valeur sur NULL et définissez la taille de la chaîne de descripteur pointée par l’argument pcDescriptorString sur zéro lors de votre appel initial à cette fonction. Pour plus d'informations, consultez la section Notes.

[in, out] pcDescriptorString

Pointeur vers une variable qui contient le nombre de caractères dans la chaîne récupérée dans le paramètre pwszDescriptorString . Définissez la variable sur zéro lors de votre appel initial à cette fonction. Pour plus d'informations, consultez la section Notes.

dwFlags

Indicateur qui spécifie la ruche du Registre à interroger pour le nom inscrit. Il peut s’agir de zéro à rechercher dans la ruche HKEY_CURRENT_USER ou vous pouvez spécifier NCRYPT_MACHINE_KEY_FLAG pour interroger la ruche HKEY_LOCAL_MACHINE .

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction. Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
ERROR_SUCCESS	La fonction a réussi.
NTE_INVALID_PARAMETER	Le paramètre pwszName ne peut pas être NULL et la valeur pointée par le paramètre ne peut pas être une chaîne vide.
NTE_BAD_FLAGS	Le paramètre dwFlags doit être égal à zéro ou NCRYPT_MACHINE_KEY_FLAG.

Remarques

Pour récupérer une chaîne de règle de descripteur de protection, vous devez appeler cette fonction deux fois. La première fois que vous appelez, définissez l’argument pwszDescriptorString sur NULL et la valeur pointée par l’argument pcDescriptorString sur zéro. Votre premier appel récupère le nombre de caractères dans la chaîne de descripteur. Utilisez ce nombre pour allouer de la mémoire pour la chaîne et récupérer un pointeur vers la mémoire tampon allouée. Pour récupérer la chaîne, appelez à nouveau la fonction à l’aide du pointeur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ncryptprotect.h
Bibliothèque	NCrypt.lib
DLL	NCrypt.dll

Voir aussi

Fonctions DPAPI CNG

NCryptRegisterProtectionDescriptorName

Partager via