Função LsaSetInformationPolicy (ntsecapi.h)
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 |
|---|---|
|
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 . |
|
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 . |
|
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 . |
|
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 . |
|
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 |