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 |