LsaOpenTrustedDomainByName 関数 (ntsecapi.h)

  • [アーティクル]

LsaOpenTrustedDomainByName 関数は、リモート信頼ドメインの LSA ポリシー ハンドルを開きます。 リモート コンピューターの LSA ポリシーを設定またはクエリするために、このハンドルを LSA 関数呼び出しに渡すことができます。

構文

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

パラメーター

[in] PolicyHandle

Policy オブジェクトへのハンドル。 これは、ローカル コンピューターのポリシー ハンドルです。 詳細については、「 ポリシー オブジェクト ハンドルを開く」を参照してください。

[in] TrustedDomainName

信頼されたドメインの名前。 この名前には、フラット名またはドメイン ネーム システム (DNS) ドメイン名を指定できます。

[in] DesiredAccess

リモート の信頼 されたドメイン オブジェクトに対して要求されるアクセス許可を指定するACCESS_MASK構造体。

[out] TrustedDomainHandle

リモート信頼ドメインの LSA ポリシー ハンドルのアドレスを受け取るポインター。 このハンドルを LSA 関数呼び出しに渡して、リモート コンピューターの LSA ポリシーのクエリと管理を行うことができます。

アプリケーションでこのハンドルが不要になったら、 LsaClose を呼び出してハンドルを削除する必要があります。

戻り値

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は NTSTATUS コードであり、次の値のいずれか、または LSA ポリシー関数の戻り値のいずれかになります。

値 説明
STATUS_ACCESS_DENIED
 呼び出し元には、操作を完了するための適切なアクセス権がありません。
STATUS_OBJECT_NAME_NOT_FOUND
 ターゲット システムの LSA データベースに、指定した名前の信頼されたドメイン オブジェクトがありません。
 

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

要件

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

こちらもご覧ください

LsaClose