Função LsaSetTrustedDomainInformation (ntsecapi.h)

Artigo
03/13/2024

A função LsaSetTrustedDomainInformation modifica as informações de um objeto Policy sobre um domínio confiável.

Sintaxe

NTSTATUS LsaSetTrustedDomainInformation(
  [in] LSA_HANDLE                PolicyHandle,
  [in] PSID                      TrustedDomainSid,
  [in] TRUSTED_INFORMATION_CLASS InformationClass,
  [in] PVOID                     Buffer
);

Parâmetros

[in] PolicyHandle

Um identificador para o objeto Policy de um controlador de domínio. Os direitos de usuário 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] TrustedDomainSid

Ponteiro para o SID do domínio confiável cujas informações são modificadas. Se o parâmetro InformationClass estiver definido como TrustedDomainNameInformation, esse parâmetro deverá apontar para o SID do domínio para adicionar à lista de domínios confiáveis.

[in] InformationClass

Especifica um dos valores a seguir do tipo de enumeração TRUSTED_INFORMATION_CLASS . O valor indica o tipo de informação que está sendo definida.

Valor	Significado
TrustedDomainNameInformation	Se o domínio especificado não estiver na lista de domínios confiáveis, a função LsaSetTrustedDomainInformation o adicionará. O parâmetro TrustedDomainSid deve ser o SID do domínio a ser adicionado. O parâmetro Buffer deve ser um ponteiro para uma estrutura TRUSTED_DOMAIN_NAME_INFO que contém o nome do domínio a ser adicionado. Se o domínio especificado já estiver na lista de domínios confiáveis, a função falhará.
TrustedPosixOffsetInformation	Define o valor usado para gerar identificadores de usuário e grupo posix. O parâmetro Buffer deve ser um ponteiro para uma estrutura TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Define a senha do domínio confiável. O parâmetro Buffer deve ser um ponteiro para uma estrutura TRUSTED_PASSWORD_INFO que contém as senhas antigas e novas para o domínio especificado. O identificador passado no parâmetro PolicyHandle deve ter o direito de acesso POLICY_CREATE_SECRET. A cadeia de caracteres de senha antiga pode ser NULL.

[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