次の方法で共有

LsaQueryForestTrustInformation 関数 (ntsecapi.h)

  • [アーティクル]

LsaQueryForestTrustInformation 関数は、指定されたローカル セキュリティ機関TrustedDomain オブジェクトのフォレスト信頼情報を取得します。

構文

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

パラメーター

[in] PolicyHandle

システムの Policy オブジェクトへのハンドル。

[in] TrustedDomainName

フォレスト の信頼 情報を取得する TrustedDomain オブジェクトの名前を含むLSA_UNICODE_STRING構造体へのポインター。

[out] ForestTrustInfo

TrustedDomainName パラメーターで指定された TrustedDomain オブジェクトのフォレスト信頼情報を返すLSA_FOREST_TRUST_INFORMATION構造体へのポインター。

戻り値

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は NTSTATUS コードであり、次の値のいずれか、または LSA ポリシー関数の戻り値のいずれかになります。

リターン コード/値 Description
STATUS_INVALID_DOMAIN_ROLE
 この操作は、プライマリ ドメイン コントローラーでのみ有効です。
STATUS_INVALID_DOMAIN_STATE
 この操作は、ルート ドメイン内のドメイン コントローラーでのみ有効です。
STATUS_NO_SUCH_DOMAIN
 指定された TrustedDomain オブジェクトが存在しません。
STATUS_NOT_FOUND
 指定した TrustedDomain オブジェクトには、フォレストの信頼情報が含まれていません。

注釈

この関数へのアクセスは、セキュリティ保護可能なオブジェクトによって保護されます。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecapi.h
Library Advapi32.lib
[DLL] Advapi32.dll