Função RegSetKeySecurity (winreg.h)

Artigo
03/04/2024

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