Função LsaCreateTrustedDomainEx (ntsecapi.h)

Artigo
08/25/2023

A função LsaCreateTrustedDomainEx estabelece um novo domínio confiável criando um novo objeto TrustedDomain .

Sintaxe

NTSTATUS LsaCreateTrustedDomainEx(
  [in]  LSA_HANDLE                       PolicyHandle,
  [in]  PTRUSTED_DOMAIN_INFORMATION_EX   TrustedDomainInformation,
  [in]  PTRUSTED_DOMAIN_AUTH_INFORMATION AuthenticationInformation,
  [in]  ACCESS_MASK                      DesiredAccess,
  [out] PLSA_HANDLE                      TrustedDomainHandle
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Para que o objeto seja criado, o chamador deve ter permissão para criar filhos no contêiner sistema . Para obter informações sobre identificadores de objeto de política, consulte Abrindo um identificador de objeto de política.

[in] TrustedDomainInformation

Ponteiro para uma estrutura TRUSTED_DOMAIN_INFORMATION_EX que contém o nome e o SID do novo domínio confiável.

[in] AuthenticationInformation

Ponteiro para uma estrutura TRUSTED_DOMAIN_AUTH_INFORMATION que contém informações de autenticação para o novo domínio confiável.

[in] DesiredAccess

Uma estrutura ACCESS_MASK que especifica os acessos a serem concedidos para o novo domínio confiável.

[out] TrustedDomainHandle

Recebe o identificador de política LSA do domínio confiável remoto. Você pode passar esse identificador para chamadas de função LSA para gerenciar a política LSA do domínio confiável.

Quando o aplicativo não precisar mais desse identificador, ele deverá chamar LsaClose para excluir o identificador.

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará um código NTSTATUS , que pode ser um dos valores a seguir ou um dos valores retornados da função de política LSA.

Código de retorno	Descrição
STATUS_DIRECTORY_SERVICE_REQUIRED	O sistema de destino (especificado no parâmetro TrustedDomainInformation ) para o objeto TrustedDomain não é um controlador de domínio.
STATUS_INVALID_SID	O SID especificado não é válido.
STATUS_UNSUCCESSFUL	Não é possível determinar se o sistema de destino é um controlador de domínio.

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

Comentários

LsaCreateTrustedDomainEx não marcar se o nome de domínio especificado corresponde ao SID especificado ou se o SID e o nome representam um domínio real.

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