Función NCryptGetProtectionDescriptorInfo (ncryptprotect.h)

  • Artículo

La función NCryptGetProtectionDescriptorInfo recupera una cadena de regla de descriptor de protección.

Sintaxis

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

Parámetros

[in] hDescriptor

Identificador de descriptor de protección creado mediante una llamada a NCryptCreateProtectionDescriptor.

[in, optional] pMemPara

Puntero a una estructura de NCRYPT_ALLOC_PARA que puede usar para especificar funciones de administración de memoria personalizadas. Si establece este argumento en NULL, la función LocalAlloc se usa internamente para asignar memoria y la aplicación debe llamar a LocalFree para liberar memoria a la que apunta el parámetro ppvInfo .

dwInfoType

Especifica cómo devolver información de descriptor al parámetro ppvInfo . Puede ser el siguiente valor:

Valor Significado
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 El argumento ppvInfo devuelve la cadena de regla del descriptor.

[out] ppvInfo

Puntero a la información del descriptor.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función. Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código devuelto Descripción
ERROR_SUCCESS
 La función se realizó correctamente.
NTE_INVALID_PARAMETER
 El parámetro ppvInfo no puede ser NULL.
NTE_NOT_SUPPORTED
 Se especificó un valor no admitido en el parámetro dwInfoType .
NTE_INVALID_HANDLE
 El identificador especificado por el parámetro hDescriptor no es válido.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ncryptprotect.h
Library NCrypt.lib
Archivo DLL NCrypt.dll

Consulte también

Funciones de DPAPI de CNG

NCryptCreateProtectionDescriptor