LsaQueryTrustedDomainInfo 関数 (ntsecapi.h)

[アーティクル]
08/25/2023

LsaQueryTrustedDomainInfo 関数は、信頼されたドメインに関する情報を取得します。

構文

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

パラメーター

[in] PolicyHandle

TrustedDomainSid パラメーターによって識別されるドメインとの信頼関係を持つドメインコントローラーの Policy オブジェクトへのハンドル。ハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。詳細については、「ポリシーオブジェクトハンドルを開く」を参照してください。

[in] TrustedDomainSid

クエリを実行する信頼されたドメインの SID へのポインター。

[in] InformationClass

TRUSTED_INFORMATION_CLASS列挙型から次のいずれかの値を指定します。値は、要求される情報の種類を示します。

値	意味
TrustedDomainNameInformation	信頼されたドメインの名前を取得します。 Buffer パラメーターは、TRUSTED_DOMAIN_NAME_INFO構造体へのポインターを受け取ります。
TrustedPosixOffsetInformation	信頼されたドメインの Posix ユーザー識別子とグループ識別子の生成に使用される値を取得します。 Buffer パラメーターは、TRUSTED_POSIX_OFFSET_INFO構造体へのポインターを受け取ります。
TrustedPasswordInformation	信頼されたドメインのパスワードを取得します。 Buffer パラメーターは、TRUSTED_PASSWORD_INFO構造体へのポインターを受け取ります。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_GET_PRIVATE_INFORMATIONアクセス権が必要です。
TrustedDomainInformationEx	信頼されたドメインの拡張情報を取得します。 Buffer パラメーターは、TRUSTED_DOMAIN_INFORMATION_EX構造体へのポインターを受け取ります。
TrustedDomainInformationBasic	この値はサポートされていません。
TrustedDomainFullInformation	信頼されたドメインの完全な情報を取得します。この情報には、Posix オフセット情報、認証情報、および TrustedDomainInformationEx 値に対して返される拡張情報が含まれます。 Buffer パラメーターは、TRUSTED_DOMAIN_FULL_INFORMATION構造体へのポインターを受け取ります。

[out] Buffer

要求された情報を含む構造体へのポインターを受け取るバッファーへのポインター。構造体の種類は 、InformationClass パラメーターの値によって異なります。

情報の使用が完了したら、返されたポインターを LsaFreeMemory に渡して解放します。

戻り値

関数が成功した場合、関数はSTATUS_SUCCESSを返します。

関数が失敗した場合は、エラーを示す NTSTATUS 値を返します。詳細については、「 LSA ポリシー関数の戻り値」を参照してください。

LsaNtStatusToWinError 関数を使用して、NTSTATUS 値を Windows エラーコードに変換できます。

要件

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