Función NCryptRegisterProtectionDescriptorName (ncryptprotect.h)

La función NCryptRegisterProtectionDescriptorName registra el nombre para mostrar y la cadena de regla asociada para un descriptor de protección.

Sintaxis

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

Parámetros

[in] pwszName

Puntero a una cadena Unicode terminada en null que contiene el nombre para mostrar del descriptor que se va a registrar.

[in, optional] pwszDescriptorString

Puntero a una cadena Unicode terminada en null que contiene una regla de descriptor de protección. Si este parámetro es NULL o la cadena está vacía, se eliminará el valor del Registro creado previamente para el parámetro pwszName .

dwFlags

Constante que indica el subárbol del Registro en el que se va a registrar la nueva entrada. Si este valor es cero (0), la raíz del Registro se HKEY_CURRENT_USER. Si este valor es NCRYPT_MACHINE_KEY_FLAG, la raíz se 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

La clave del Registro creada mediante esta función no es volátil. La información se almacena en un archivo y se conserva cuando el equipo se apaga.

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

NCryptQueryProtectionDescriptorName