NCryptGetProtectionDescriptorInfo, fonction (ncryptprotect.h)

Article
08/25/2023

La fonction NCryptGetProtectionDescriptorInfo récupère une chaîne de règle de descripteur de protection.

Syntaxe

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

Paramètres

[in] hDescriptor

Handle de descripteur de protection créé en appelant NCryptCreateProtectionDescriptor.

[in, optional] pMemPara

Pointeur vers une structure NCRYPT_ALLOC_PARA que vous pouvez utiliser pour spécifier des fonctions de gestion de mémoire personnalisées. Si vous définissez cet argument sur NULL, la fonction LocalAlloc est utilisée en interne pour allouer de la mémoire et votre application doit appeler LocalFree pour libérer la mémoire vers laquelle pointe le paramètre ppvInfo .

dwInfoType

Spécifie comment retourner les informations de descripteur au paramètre ppvInfo . Il peut s’agir de la valeur suivante :

Valeur	Signification
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING	L’argument ppvInfo retourne la chaîne de règle de descripteur.

[out] ppvInfo

Pointeur vers les informations de descripteur.

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 ppvInfo ne peut pas être NULL.
NTE_NOT_SUPPORTED	Une valeur non prise en charge a été spécifiée dans le paramètre dwInfoType .
NTE_INVALID_HANDLE	Le handle spécifié par le paramètre hDescriptor n’est pas valide.

Spécifications


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

NCryptCreateProtectionDescriptor

Partager via