Função NCryptRegisterProtectionDescriptorName (ncryptprotect.h)
A função NCryptRegisterProtectionDescriptorName registra o nome de exibição e a cadeia de caracteres de regra associada para um descritor de proteção.
Sintaxe
SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
[in] LPCWSTR pwszName,
[in, optional] LPCWSTR pwszDescriptorString,
DWORD dwFlags
);
Parâmetros
[in] pwszName
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de exibição do descritor a ser registrado.
[in, optional] pwszDescriptorString
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém uma regra de descritor de proteção. Se esse parâmetro for NULL ou a cadeia de caracteres estiver vazia, o valor do Registro criado anteriormente para o parâmetro pwszName será excluído.
dwFlags
Uma constante que indica o hive do Registro sob o qual registrar a nova entrada. Se esse valor for zero (0), a raiz do Registro será HKEY_CURRENT_USER. Se esse valor for NCRYPT_MACHINE_KEY_FLAG, a raiz será HKEY_LOCAL_MACHINE.
Retornar valor
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 |
---|---|
|
A função foi bem-sucedida. |
|
O parâmetro pwszName não pode ser NULL e o valor apontado pelo parâmetro não pode ser uma cadeia de caracteres vazia. |
|
O parâmetro dwFlags deve ser zero ou NCRYPT_MACHINE_KEY_FLAG. |
Comentários
A chave do Registro criada usando essa função não é volátil. As informações são armazenadas em um arquivo e preservadas quando o computador é desligado.
Requisitos
Requisito | Valor |
---|---|
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 |