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 |
---|---|
|
この操作は、ルート ドメイン内のドメイン コントローラーでのみ有効です。 |
|
この操作は、プライマリ ドメイン コントローラーでのみ有効です。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | ntsecapi.h |
Library | Advapi32.lib |
[DLL] | Advapi32.dll |