Compartilhar via


Função RegSetKeySecurity (winreg.h)

A função RegSetKeySecurity define a segurança de uma chave do Registro aberta.

Sintaxe

LSTATUS RegSetKeySecurity(
  [in] HKEY                 hKey,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parâmetros

[in] hKey

Um identificador para uma chave aberta para a qual o descritor de segurança está definido.

[in] SecurityInformation

Um conjunto de sinalizadores de bits que indicam o tipo de informações de segurança a serem definidas. Esse parâmetro pode ser uma combinação dos sinalizadores de bits SECURITY_INFORMATION .

[in] pSecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que especifica os atributos de segurança a serem definidos para a chave especificada.

Retornar valor

Se a função for bem-sucedida, a função retornará ERROR_SUCCESS.

Se a função falhar, ela retornará um código de erro diferente de zero definido em WinError.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.

Comentários

Se hKey for uma das chaves predefinidas, use a função RegCloseKey para fechar a chave predefinida para garantir que as novas informações de segurança entrem em vigor na próxima vez que a chave predefinida for referenciada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winreg.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

FormatMessage

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível

Regclosekey

RegDeleteKey

RegGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION