Fonction DsGetForestTrustInformationW (dsgetdc.h)
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 |