次の方法で共有


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