DsGetForestTrustInformationW 関数 (dsgetdc.h)

DsGetForestTrustInformationW 関数は、指定されたドメインのフォレスト信頼データを取得します。

構文

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

パラメーター

[in, optional] ServerName

DsGetForestTrustInformationW がリモートで接続されているドメイン コントローラーの名前を格納します。 呼び出し元は、このサーバーで認証されたユーザーである必要があります。 このパラメーターが NULL の場合は、ローカル サーバーが使用されます。

[in, optional] TrustedDomainName

フォレストの信頼データを取得する信頼されたドメインの NETBIOS または DNS 名が含まれます。 このドメインには 、TRUST_ATTRIBUTE_FOREST_TRANSITIVE 信頼属性が必要です。 詳細については、「 TRUSTED_DOMAIN_INFORMATION_EX」を参照してください。

このパラメーターが NULL の場合、 ServerName によってホストされているドメインのフォレスト信頼データが取得されます。

[in] Flags

この関数の動作を変更するフラグのセットが含まれています。 0 または次の値を指定できます。

DS_GFTI_UPDATE_TDO

このフラグが設定されている場合、 DsGetForestTrustInformationW は TrustedDomainName パラメーターによって識別される信頼されたドメインのフォレスト信頼データを更新します。 この場合、 TrustedDomainName パラメーターを NULL にすることはできません。 呼び出し元は、信頼データを変更するためのアクセス権を持っているか 、ERROR_ACCESS_DENIED が返される必要があります。

このフラグは、 ServerName でドメインのプライマリ ドメイン コントローラーが指定されている場合にのみ有効です。

[out] ForestTrustInfo

TrustedDomainName で指定されたドメインによって要求された名前空間を記述するフォレスト信頼データを受け取るLSA_FOREST_TRUST_INFORMATION構造体ポインターへのポインター。 返されるすべてのレコードの Time メンバーは 0 になります。

NetApiBufferFree を呼び出して不要になった場合、呼び出し元はこの構造体を解放する必要があります。

戻り値

成功した場合 はNO_ERROR を返し、それ以外の場合は Win32 エラー コードを返します。 考えられるエラー コードは次のとおりです。

要件

関連項目

ディレクトリ サービス関数

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX