Função NCryptRegisterProtectionDescriptorName (ncryptprotect.h)

  • Artigo

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
ERROR_SUCCESS
 A função foi bem-sucedida.
NTE_INVALID_PARAMETER
 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.
NTE_BAD_FLAGS
 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

Confira também

Funções DPAPI do CNG

NCryptQueryProtectionDescriptorName