次の方法で共有

IVdsLun::AddPlex メソッド (vdshwprv.h)

  • [アーティクル]

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

ターゲット LUN に新しいプレックスとして LUN を追加します。

構文

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID lunId,
  [out] IVdsAsync     **ppAsync
);

パラメーター

[in] lunId

プレックスとして追加する LUN の GUID。

[out] ppAsync

戻り時に VDS が初期化する IVdsAsync インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。 このインターフェイスを使用して、操作の状態を取り消す、待機する、またはクエリを実行します。

戻り値

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

リターン コード/値 Description
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 この戻り値は、配列に関する情報をキャッシュするプロバイダー内のソフトウェアまたは通信の問題を示します。 キャッシュを復元するには、 IVdsHwProvider::Reenumerate メソッドの後に IVdsHwProvider::Refresh メソッドを使用します。
VDS_E_OBJECT_DELETED
0x8004240BL
 LUN オブジェクトが存在しなくなりました。
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 LUN は失敗状態であり、要求された操作を実行できません。
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 別の操作が進行中です。 この操作は、前の操作または操作が完了するまで続行できません。
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 これは、 VDS_OBJECT_ID 定数を受け取る任意のメソッドから返すことができます。 識別子が既存のオブジェクトを参照していないことを示します。
VDS_E_INVALID_OPERATION
0x80042415L
 操作が無効です。 または、ソース LUN がターゲット LUN よりも小さくなります。 ソース LUN がターゲット LUN より大きい場合、ターゲット LUN のサイズは変わらず、操作は成功します。

注釈

呼び出し元が新しい LUN をプレックスとして追加すると、LUN として表示されなくなります。 呼び出し元が
はミラー化された LUN を追加します。VDS には、個別のプレックスとして各プレックスが含まれます。 追加された LUN のすべてのデータが失われます。

実装者は、呼び出しが非同期操作を開始するかどうかに関係なく、このメソッドの IVdsAsync インターフェイスへのポインターを返す必要があります。

要件

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

こちらもご覧ください

IVdsAsync

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun