Função LsaOpenTrustedDomainByName (ntsecapi.h)

Artigo
08/25/2023

A função LsaOpenTrustedDomainByName abre o identificador de política LSA de um domínio confiável remoto. Você pode passar esse identificador para chamadas de função LSA para definir ou consultar a política LSA do computador remoto.

Sintaxe

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Esse é o identificador de política do computador local. Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] TrustedDomainName

Nome do domínio confiável. Esse nome pode ser o nome simples ou o nome de domínio DNS (Sistema de Nomes de Domínio).

[in] DesiredAccess

Uma estrutura ACCESS_MASK que especifica as permissões de acesso solicitadas no objeto de domínio confiável remoto.

[out] TrustedDomainHandle

Ponteiro que recebe o endereço do identificador de política LSA do domínio confiável remoto. Você pode passar esse identificador para chamadas de função LSA para consultar e gerenciar a política LSA do computador remoto.

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, o valor retornado será STATUS_SUCCESS.

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

Valor	Descrição
STATUS_ACCESS_DENIED	O chamador não tem o acesso apropriado para concluir a operação.
STATUS_OBJECT_NAME_NOT_FOUND	Não há nenhum objeto domínio confiável no banco de dados LSA do sistema de destino com o nome especificado.

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

LsaClose

Compartilhar via