Función NCryptQueryProtectionDescriptorName (ncryptprotect.h)

La función NCryptQueryProtectionDescriptorName recupera la cadena de regla del descriptor de protección asociada a un nombre para mostrar del descriptor registrado.

Sintaxis

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

Parámetros

[in] pwszName

Nombre para mostrar registrado para el descriptor de protección. Registre un nombre llamando a la función NCryptRegisterProtectionDescriptorName .

[out] pwszDescriptorString

Cadena Unicode terminada en null que contiene la regla de descriptor de protección. Establezca este valor en NULL y establezca el tamaño de la cadena de descriptor a la que apunta el argumento pcDescriptorString en cero en la llamada inicial a esta función. Para obtener más información, vea la sección Comentarios.

[in, out] pcDescriptorString

Puntero a una variable que contiene el número de caracteres de la cadena recuperada en el parámetro pwszDescriptorString . Establezca la variable en cero en la llamada inicial a esta función. Para obtener más información, vea la sección Comentarios.

dwFlags

Marca que especifica qué subárbol del Registro se va a consultar para el nombre registrado. Puede ser cero para buscar en el subárbol de HKEY_CURRENT_USER o puede especificar NCRYPT_MACHINE_KEY_FLAG para consultar el subárbol HKEY_LOCAL_MACHINE .

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 pwszName no puede ser NULL y el valor al que apunta el parámetro no puede ser una cadena vacía.
NTE_BAD_FLAGS	El parámetro dwFlags debe ser cero o NCRYPT_MACHINE_KEY_FLAG.

Comentarios

Para recuperar una cadena de regla de descriptor de protección, debe llamar a esta función dos veces. La primera vez que llames, establece el argumento pwszDescriptorString en NULL y el valor al que apunta el argumento pcDescriptorString en cero. La primera llamada recupera el número de caracteres de la cadena del descriptor. Use este número para asignar memoria para la cadena y recuperar un puntero al búfer asignado. Para recuperar la cadena, vuelva a llamar a la función mediante el puntero .

Requisitos

Requisito	Value
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

NCryptRegisterProtectionDescriptorName