Função LsaCreateTrustedDomainEx (ntsecapi.h)
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 |
|---|---|
|
O sistema de destino (especificado no parâmetro TrustedDomainInformation ) para o objeto TrustedDomain não é um controlador de domínio. |
|
O SID especificado não é válido. |
|
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 |
Confira também
LsaSetTrustedDomainInformation