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列挙型から次のいずれかの値を指定します。 値は、要求される情報の種類を示します。
| 値 | 意味 |
|---|---|
|
信頼されたドメインの名前を取得します。 Buffer パラメーターは、TRUSTED_DOMAIN_NAME_INFO構造体へのポインターを受け取ります。 |
|
信頼されたドメインの Posix ユーザー識別子とグループ識別子の生成に使用される値を取得します。 Buffer パラメーターは、TRUSTED_POSIX_OFFSET_INFO構造体へのポインターを受け取ります。 |
|
信頼されたドメインのパスワードを取得します。 Buffer パラメーターは、TRUSTED_PASSWORD_INFO構造体へのポインターを受け取ります。 PolicyHandle パラメーターで渡されるハンドルには、POLICY_GET_PRIVATE_INFORMATIONアクセス権が必要です。 |
|
信頼されたドメインの拡張情報を取得します。 Buffer パラメーターは、TRUSTED_DOMAIN_INFORMATION_EX構造体へのポインターを受け取ります。 |
|
この値はサポートされていません。 |
|
信頼されたドメインの完全な情報を取得します。 この情報には、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 |