Fonction DsGetForestTrustInformationW (dsgetdc.h)

  • Article

La fonction DsGetForestTrustInformationW obtient des données d’approbation de forêt pour un domaine spécifié.

Syntaxe

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

Paramètres

[in, optional] ServerName

Contient le nom du contrôleur de domaine auquel DsGetForestTrustInformationW est connecté à distance. L’appelant doit être un utilisateur authentifié sur ce serveur. Si ce paramètre a la valeur NULL, le serveur local est utilisé.

[in, optional] TrustedDomainName

Contient le nom NETBIOS ou DNS du domaine approuvé pour lequel les données d’approbation de forêt doivent être récupérées. Ce domaine doit avoir l’attribut d’approbation TRUST_ATTRIBUTE_FOREST_TRANSITIVE . Pour plus d’informations, consultez TRUSTED_DOMAIN_INFORMATION_EX.

Si ce paramètre a la valeur NULL, les données d’approbation de forêt pour le domaine hébergé par ServerName sont récupérées.

[in] Flags

Contient un ensemble d’indicateurs qui modifient le comportement de cette fonction. Il peut s’agir de zéro ou de la valeur suivante.

DS_GFTI_UPDATE_TDO

Si cet indicateur est défini, DsGetForestTrustInformationW met à jour les données d’approbation de forêt du domaine approuvé identifié par le paramètre TrustedDomainName . Dans ce cas, le paramètre TrustedDomainName ne peut pas être NULL. L’appelant doit avoir accès pour modifier les données d’approbation ou ERROR_ACCESS_DENIED est retourné.

Cet indicateur est valide uniquement si ServerName spécifie le contrôleur de domaine principal du domaine.

[out] ForestTrustInfo

Pointeur vers un pointeur de structure LSA_FOREST_TRUST_INFORMATION qui reçoit les données d’approbation de forêt qui décrivent les espaces de noms revendiqués par le domaine spécifié par TrustedDomainName. Le membre Time de tous les enregistrements retournés sera égal à zéro.

L’appelant doit libérer cette structure lorsqu’elle n’est plus nécessaire en appelant NetApiBufferFree.

Valeur retournée

Retourne NO_ERROR en cas de réussite ou un code d’erreur Win32 dans le cas contraire. Les codes d’erreur possibles sont les suivants.

Spécifications

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête dsgetdc.h
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

Fonctions de service d’annuaire

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX