Partager via

NCryptGetProtectionDescriptorInfo, fonction (ncryptprotect.h)

  • Article

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