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列挙型から次のいずれかの値を指定します。 値は、設定されている情報の種類を示します。

値 意味
TrustedDomainNameInformation
 指定したドメインが信頼されたドメインの一覧にない場合は、 LsaSetTrustedDomainInformation 関数によって追加されます。 TrustedDomainSid パラメーターは、追加するドメインの SID である必要があります。 Buffer パラメーターは、追加するドメインの名前を含むTRUSTED_DOMAIN_NAME_INFO構造体へのポインターである必要があります。

指定したドメインが既に信頼されたドメインの一覧にある場合、関数は失敗します。
TrustedPosixOffsetInformation
 Posix ユーザー ID とグループ ID の生成に使用する値を設定します。 Buffer パラメーターは、TRUSTED_POSIX_OFFSET_INFO構造体へのポインターである必要があります。
TrustedPasswordInformation
 信頼されたドメインのパスワードを設定します。 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

こちらもご覧ください

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO