LsaQueryTrustedDomainInfoByName 関数 (ntsecapi.h)
LsaQueryTrustedDomainInfoByName 関数は、信頼されたドメインに関する情報を返します。
構文
NTSTATUS LsaQueryTrustedDomainInfoByName(
[in] LSA_HANDLE PolicyHandle,
[in] PLSA_UNICODE_STRING TrustedDomainName,
[in] TRUSTED_INFORMATION_CLASS InformationClass,
[out] PVOID *Buffer
);
パラメーター
[in] PolicyHandle
Policy オブジェクトへのハンドル。 このハンドルには、POLICY_VIEW_LOCAL_INFORMATIONアクセス権が必要です。 詳細については、「 ポリシー オブジェクト ハンドルを開く」を参照してください。
[in] TrustedDomainName
信頼されたドメインの名前を含む文字列。 ドメイン名またはフラット名を指定できます。
[in] InformationClass
取得する情報の種類を指定します。 このパラメーターには、次の値のいずれかを指定できます。
[out] Buffer
要求された情報を含む返されたバッファーへのポインターを受け取ります。 このバッファーの形式と内容は、情報クラスによって異なります。 たとえば、 InformationClass が TrustedDomainInformationEx に設定されている場合、 Buffer は TRUSTED_DOMAIN_INFORMATION_EX 構造体へのポインターを受け取ります。 詳細については、「 TRUSTED_INFORMATION_CLASS」を参照してください。
バッファーの使用が完了したら、 LsaFreeMemory 関数を呼び出して解放します。
戻り値
関数が成功した場合、関数はSTATUS_SUCCESSを返します。
関数が失敗した場合、NTSTATUS 値が返されます。 NTSTATUS 値は、次のいずれかの値または LSA ポリシー関数の戻り値のいずれかになります。
| 値 | 説明 |
|---|---|
|
呼び出し元には、操作を完了するための適切なアクセス権がありません。 必要なアクセスの種類の一覧については、 InformationClass パラメーターの説明を参照してください。 |
|
呼び出しを完了するには、メモリなどのシステム リソースが不足しています。 |
LsaNtStatusToWinError 関数を使用して、NTSTATUS 値を Windows エラー コードに変換できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecapi.h |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |