Fonction NCryptQueryProtectionDescriptorName (ncryptprotect.h)

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.

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

Voir aussi

Fonctions DPAPI CNG

NCryptRegisterProtectionDescriptorName