Função DsGetForestTrustInformationW (dsgetdc.h)

A função DsGetForestTrustInformationW obtém dados de confiança de floresta para um domínio especificado.

Sintaxe

DSGETDCAPI DWORD DsGetForestTrustInformationW(
  [in, optional] LPCWSTR                       ServerName,
  [in, optional] LPCWSTR                       TrustedDomainName,
  [in]           DWORD                         Flags,
  [out]          PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Parâmetros

[in, optional] ServerName

Contém o nome do controlador de domínio ao qual DsGetForestTrustInformationW está conectado remotamente. O chamador deve ser um usuário autenticado neste servidor. Se esse parâmetro for NULL, o servidor local será usado.

[in, optional] TrustedDomainName

Contém o nome NETBIOS ou DNS do domínio confiável para o qual os dados de confiança da floresta devem ser recuperados. Esse domínio deve ter o atributo de confiança TRUST_ATTRIBUTE_FOREST_TRANSITIVE . Para obter mais informações, consulte TRUSTED_DOMAIN_INFORMATION_EX.

Se esse parâmetro for NULL, os dados de confiança da floresta para o domínio hospedado por ServerName serão recuperados.

[in] Flags

Contém um conjunto de sinalizadores que modificam o comportamento dessa função. Isso pode ser zero ou o valor a seguir.

DS_GFTI_UPDATE_TDO

Se esse sinalizador for definido, DsGetForestTrustInformationW atualizará os dados de confiança da floresta do domínio confiável identificado pelo parâmetro TrustedDomainName . Nesse caso, o parâmetro TrustedDomainName não pode ser NULL. O chamador deve ter acesso para modificar os dados de confiança ou ERROR_ACCESS_DENIED é retornado.

Esse sinalizador só será válido se ServerName especificar o controlador de domínio primário do domínio.

[out] ForestTrustInfo

Ponteiro para um ponteiro de estrutura LSA_FOREST_TRUST_INFORMATION que recebe os dados de confiança da floresta que descrevem os namespaces reivindicados pelo domínio especificado por TrustedDomainName. O membro Time de todos os registros retornados será zero.

O chamador deve liberar essa estrutura quando ela não for mais necessária chamando NetApiBufferFree.

Valor retornado

Retorna NO_ERROR se tiver êxito ou um código de erro Win32 caso contrário. Os códigos de erro possíveis incluem o seguinte.

Requisitos

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	dsgetdc.h
Biblioteca	Netapi32.lib
DLL	Netapi32.dll

Confira também

Funções de serviço de diretório

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX