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

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