次の方法で共有

IVdsIscsiInitiatorAdapter::LoginToTarget メソッド (vds.h)

  • [アーティクル]

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

iSCSI ターゲットへの手動ログインを実行します。

構文

HRESULT LoginToTarget(
  [in]  VDS_ISCSI_LOGIN_TYPE loginType,
  [in]  VDS_OBJECT_ID        targetId,
  [in]  VDS_OBJECT_ID        targetPortalId,
  [in]  VDS_OBJECT_ID        initiatorPortalId,
  [in]  ULONG                ulLoginFlags,
  [in]  BOOL                 bHeaderDigest,
  [in]  BOOL                 bDataDigest,
  [in]  VDS_ISCSI_AUTH_TYPE  authType,
  [out] IVdsAsync            **ppAsync
);

パラメーター

[in] loginType

VDS_ISCSI_LOGIN_TYPEで列挙して実行されるログインの種類。

[in] targetId

ログイン先のターゲットの VDS_OBJECT_ID 。 GUID_NULL は、イニシエーターがポータルを選択することを示します。

[in] targetPortalId

ログイン操作の実行に使用するターゲット ポータルの VDS_OBJECT_ID 。 GUID_NULL は、イニシエーターがポータルを選択することを示します。

[in] initiatorPortalId

ログイン操作を実行するイニシエーター ポータルの VDS_OBJECT_ID 。

[in] ulLoginFlags

ログイン オプションを指定 VDS_ISCSI_LOGIN_FLAG によって列挙されるフラグ。

[in] bHeaderDigest

TRUE の場合、イニシエーターはターゲット ポータルにログインするときにヘッダー ダイジェストを有効にする必要があります。

[in] bDataDigest

TRUE の場合、イニシエーターはターゲット ポータルにログインするときにデータ ダイジェストを有効にする必要があります。

[in] authType

ターゲットにログインするために必要な認証の種類 。 VDS_ISCSI_AUTH_TYPEによって列挙されます。

[out] ppAsync

IVdsAsync インターフェイス ポインターのアドレス。 VDS は、リターン時にインターフェイスを初期化します。 呼び出し元はインターフェイスを解放する必要があります。 このインターフェイスを使用して、操作の状態を取り消す、待機する、またはクエリを実行します。 このインターフェイスで IVdsAsync::Wait が呼び出され、成功した HRESULT 値が返された場合、各インターフェイス ポインターで IUnknown::Release メソッドを呼び出して、VDS_ASYNC_OUTPUT構造体で返されるインターフェイスを解放する必要があります。 ただし、Wait がエラー HRESULT 値を返す場合、または Wait の pHrResult パラメーターがエラー HRESULT 値を受け取った場合、VDS_ASYNC_OUTPUT構造体内のインターフェイス ポインターは NULL であり、解放する必要はありません。 成功または失敗の HRESULT 値をテストするには、Winerror.h で定義 されている SUCCEEDED マクロと FAILED マクロを使用します。

戻り値

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。

リターン コード/値 説明
S_OK
 ログインが正常に完了しました。
VDS_E_ISCSI_LOGIN_FAILED
0x80042708L
 別の操作が進行中です。 この操作は、前の操作が完了するまで続行できません。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vds.h
Library Uuid.lib
再頒布可能パッケージ VDS 1.1

関連項目

IVdsAsync

IVdsIscsiInitiatorAdapter

VDS_ISCSI_AUTH_TYPE

VDS_ISCSI_LOGIN_FLAG

VDS_ISCSI_LOGIN_TYPE