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 |
---|---|
|
La función se realizó correctamente. |
|
El parámetro pwszName no puede ser NULL y el valor al que apunta el parámetro no puede ser una cadena vacía. |
|
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 |