LsaSetForestTrustInformation 関数 (ntsecapi.h)

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

構文

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

パラメーター

[in] PolicyHandle

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

[in] TrustedDomainName

ForestTrustInfoパラメーターで指定されたフォレストの信頼情報を設定する TrustedDomain オブジェクトの名前を含むLSA_UNICODE_STRING構造体へのポインター。

[in] ForestTrustInfo

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

[in] CheckOnly

TrustedDomain オブジェクトへの変更を永続化するかどうかを指定するブール値。 この値が TRUE の場合、この関数は、指定したパラメーターとの競合をチェックしますが、ForestTrustInfo パラメーターで指定されたフォレストの信頼情報を TrustedDomainName パラメーターで指定された TrustedDomain オブジェクトに設定しません。 この値が FALSE の場合、フォレストの信頼情報は TrustedDomain オブジェクトに設定されます。

[out] CollisionInfo

発生した競合に関する情報を返す LSA_FOREST_TRUST_COLLISION_INFORMATION 構造体へのポインター。

戻り値

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

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

リターン コード/値	Description
STATUS_INVALID_DOMAIN_STATE	この操作は、ルート ドメイン内のドメイン コントローラーでのみ有効です。
STATUS_INVALID_DOMAIN_ROLE	この操作は、プライマリ ドメイン コントローラーでのみ有効です。

要件

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