Função NCryptGetProtectionDescriptorInfo (ncryptprotect.h)

Artigo
08/25/2023

A função NCryptGetProtectionDescriptorInfo recupera uma cadeia de caracteres de regra do descritor de proteção.

Sintaxe

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 descritor de proteção criado chamando NCryptCreateProtectionDescriptor.

[in, optional] pMemPara

Ponteiro para uma estrutura NCRYPT_ALLOC_PARA que você pode usar para especificar funções de gerenciamento de memória personalizadas. Se você definir esse argumento como NULL, a função LocalAlloc será usada internamente para alocar memória e seu aplicativo deverá chamar LocalFree para liberar a memória apontada pelo parâmetro ppvInfo .

dwInfoType

Especifica como retornar informações de descritor para o parâmetro ppvInfo . Esse pode ser o seguinte valor:

Valor	Significado
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING	O argumento ppvInfo retorna a cadeia de caracteres de regra do descritor.

[out] ppvInfo

Ponteiro para as informações do descritor.

Valor retornado

Retorna um código status que indica o êxito ou a falha da função. Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
ERROR_SUCCESS	A função foi bem-sucedida.
NTE_INVALID_PARAMETER	O parâmetro ppvInfo não pode ser NULL.
NTE_NOT_SUPPORTED	Um valor sem suporte foi especificado no parâmetro dwInfoType .
NTE_INVALID_HANDLE	O identificador especificado pelo parâmetro hDescriptor não é válido.

Requisitos


Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ncryptprotect.h
Biblioteca	NCrypt.lib
DLL	NCrypt.dll

Confira também

Funções DPAPI do CNG

NCryptCreateProtectionDescriptor

Compartilhar via