ホーム › Storage.VirtualDiskService › IVdsDisk2

IVdsDisk2

COM

📘 Microsoft Learn (日本語) · English

IID40f73c8b-687d-4a13-8d96-3d7f2e683936継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ディスクのSANモードをオフラインまたはオンラインに設定するためのメソッドを提供します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetSANMode(BOOL bEnable)

ディスクのSANモードをオフラインまたはオンラインに設定します。

bEnable

BOOL

オンラインの場合は TRUE を、オフラインの場合は FALSE を指定します。

戻り値

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

リターンコード/値	説明
S_OK	SANモードが正常に設定されました。
VDS_E_FAILED_TO_OFFLINE_DISK 0x80042597L	オフライン操作に失敗しました。
VDS_E_FAILED_TO_ONLINE_DISK 0x80042596L	オンライン操作に失敗しました。

解説(Remarks)

ディスクのSANモードをオフラインに設定することを、ディスクの「オフライン化」と呼びます。オンラインに設定することを、ディスクの「オンライン化」と呼びます。

Windows Vista: ディスクのSANモードをオフラインに設定すると、ディスクは読み取り専用にもなります。オンラインに設定すると、ディスクは読み取り/書き込み可能にもなります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IVdsDisk2 "{40F73C8B-687D-4A13-8D96-3D7F2E683936}"
#usecom global IVdsDisk2 IID_IVdsDisk2 "{}"
#comfunc global IVdsDisk2_SetSANMode  3 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。