Função LsaSetInformationPolicy (ntsecapi.h)

  • Artigo

A função LsaSetInformationPolicy modifica informações em um objeto Policy .

Sintaxe

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Os direitos de acesso necessários para esse identificador dependem do valor do parâmetro InformationClass . Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] InformationClass

Especifica um dos valores a seguir do tipo de enumeração POLICY_INFORMATION_CLASS . O valor indica o tipo de informação a ser definido.

Valor Significado
PolicyAuditEventsInformation
 Define as regras de auditoria do sistema. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_SET_AUDIT_REQUIREMENTS direito. O parâmetro Buffer deve ser um ponteiro para uma estrutura de POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation
 Define o nome e o SID do domínio primário do sistema. O identificador passado no parâmetro PolicyHandle deve ter o POLICY_TRUST_ADMIN direito de acesso. O parâmetro Buffer deve ser um ponteiro para uma estrutura de POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation
 Define o nome e o SID do domínio da conta do sistema. O identificador passado no parâmetro PolicyHandle deve ter o POLICY_TRUST_ADMIN direito de acesso. O parâmetro Buffer deve ser um ponteiro para uma estrutura de POLICY_ACCOUNT_DOMAIN_INFO .
PolicyDnsDomainInformation
 Define informações do DNS (Sistema de Nomes de Domínio) sobre o domínio primário associado ao objeto Policy . O identificador passado no parâmetro PolicyHandle deve ter o POLICY_TRUST_ADMIN direito de acesso. O parâmetro Buffer deve ser um ponteiro para uma estrutura de POLICY_DNS_DOMAIN_INFO .
PolicyLsaServerRoleInformation
 Define a função de um servidor LSA. O identificador passado no parâmetro PolicyHandle deve ter o acesso POLICY_SERVER_ADMIN correto. O parâmetro Buffer deve ser um ponteiro para uma estrutura de POLICY_LSA_SERVER_ROLE_INFO .

A alteração da função de um servidor de primário para backup não tem efeito (embora a função retorne STATUS_SUCCESS). A alteração da função de um servidor do backup para o primário requer operações de rede extensas e pode ser lenta.

[in] Buffer

Ponteiro para uma estrutura que contém as informações a serem definidas. O tipo de estrutura depende do valor do parâmetro InformationClass .

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS. Para obter mais informações, consulte Valores retornados da função de política LSA.

Você pode usar a função LsaNtStatusToWinError para converter o código NTSTATUS em um código de erro do Windows.

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 ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO