LsaSetTrustedDomainInformation 関数 (ntsecapi.h)
LsaSetTrustedDomainInformation 関数は、信頼されたドメインに関する Policy オブジェクトの情報を変更します。
構文
NTSTATUS LsaSetTrustedDomainInformation(
[in] LSA_HANDLE PolicyHandle,
[in] PSID TrustedDomainSid,
[in] TRUSTED_INFORMATION_CLASS InformationClass,
[in] PVOID Buffer
);
パラメーター
[in] PolicyHandle
ドメイン コントローラーの Policy オブジェクトへのハンドル。 このハンドルに必要なユーザー権限は 、InformationClass パラメーターの値によって異なります。 詳細については、「 ポリシー オブジェクト ハンドルを開く」を参照してください。
[in] TrustedDomainSid
情報が変更された信頼されたドメインの SID へのポインター。 InformationClass パラメーターが TrustedDomainNameInformation に設定されている場合、このパラメーターは、信頼されたドメインの一覧に追加するドメインの SID をポイントする必要があります。
[in] InformationClass
TRUSTED_INFORMATION_CLASS列挙型から次のいずれかの値を指定します。 値は、設定されている情報の種類を示します。
| 値 | 意味 |
|---|---|
|
指定したドメインが信頼されたドメインの一覧にない場合は、 LsaSetTrustedDomainInformation 関数によって追加されます。
TrustedDomainSid パラメーターは、追加するドメインの SID である必要があります。
Buffer パラメーターは、追加するドメインの名前を含むTRUSTED_DOMAIN_NAME_INFO構造体へのポインターである必要があります。
指定したドメインが既に信頼されたドメインの一覧にある場合、関数は失敗します。 |
|
Posix ユーザー ID とグループ ID の生成に使用する値を設定します。 Buffer パラメーターは、TRUSTED_POSIX_OFFSET_INFO構造体へのポインターである必要があります。 |
|
信頼されたドメインのパスワードを設定します。 Buffer パラメーターは、指定されたドメインの古いパスワードと新しいパスワードを含むTRUSTED_PASSWORD_INFO構造体へのポインターである必要があります。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_CREATE_SECRETアクセス権が必要です。 古いパスワード文字列は NULL にすることができます。 |
[in] Buffer
設定する情報を含む構造体へのポインター。 構造体の種類は 、InformationClass パラメーターの値によって異なります。
戻り値
関数が成功した場合、戻り値はSTATUS_SUCCESS。
関数が失敗した場合、戻り値は NTSTATUS コードです。 詳細については、「 LSA ポリシー関数の戻り値」を参照してください。
LsaNtStatusToWinError 関数を使用して、NTSTATUS コードを Windows エラー コードに変換できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecapi.h |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |