ホーム › Storage.VirtualDiskService › IVdsVDisk

IVdsVDisk

COM

IID1e062b84-e5e6-4b4b-8a25-67b81e8f13e8継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

仮想ディスクを管理するためのメソッドを定義します。(IVdsVDisk)

メソッド 4

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

vtbl 3 HRESULT Open(VIRTUAL_DISK_ACCESS_MASK AccessMask, OPEN_VIRTUAL_DISK_FLAG Flags, DWORD ReadWriteDepth, IVdsOpenVDisk** ppOpenVDisk)

指定された仮想ディスクファイルへのハンドルを開き、開いたハンドルを表すオブジェクトへの IVdsOpenVDisk インターフェイスポインターを返します。

AccessMask	VIRTUAL_DISK_ACCESS_MASK	in	開かれた仮想ディスクに適用するアクセス権を指定する VIRTUAL_DISK_ACCESS_MASK フラグのビットマスクです。
Flags	OPEN_VIRTUAL_DISK_FLAG	in	仮想ディスクをどのように開くかを指定する OPEN_VIRTUAL_DISK_FLAG フラグのビットマスクです。
ReadWriteDepth	DWORD	in	バッキングストアチェーンのうち、子から始めて読み取り/書き込みで開くストア(バッキングファイル)の数です。差分チェーン内の残りのストアは読み取り専用で開かれます。(これはマージ操作を成功させるために必要です。)
ppOpenVDisk	IVdsOpenVDisk**	out	仮想ディスクオブジェクトに対して開かれたハンドルを表す、新しく作成されたオブジェクトへの IVdsOpenVDisk インターフェイスポインターを受け取る変数へのポインターです。呼び出し元は、インターフェイスポインターが不要になったら IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

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

戻り値	説明
S_OK	メソッドは正常に完了しました。

解説(Remarks)

アプリケーションは、CoInitializeSecurity 関数を呼び出してプロセス全体のセキュリティを初期化する必要があります。dwImpLevel パラメーターは RPC_C_IMP_LEVEL_IMPERSONATE に設定する必要があります。

Windows Server 2008、Windows Vista および Windows Server 2003: これらの操作は Windows 7 および Windows Server 2008 R2 までは必要ありません。

vtbl 4 HRESULT GetProperties(VDS_VDISK_PROPERTIES* pDiskProperties)

仮想ディスクが存在するボリュームのディスクプロパティ情報を返します。

pDiskProperties

VDS_VDISK_PROPERTIES*

out

ディスクプロパティ情報を格納する VDS_VDISK_PROPERTIES 構造体へのポインターを受け取ります。

戻り値

戻り値	説明
S_OK	メソッドは正常に完了しました。

vtbl 5 HRESULT GetHostVolume(IVdsVolume** ppVolume)

仮想ディスクが存在するボリュームのボリュームオブジェクトへのインターフェイスポインターを返します。

ppVolume

IVdsVolume**

out

ボリュームの IVdsVolume インターフェイスポインターを受け取る変数へのポインターです。呼び出し元は、インターフェイスポインターが不要になったら IUnknown::Release メソッドを呼び出して解放する必要があります。

戻り値

戻り値	説明
S_OK	メソッドは正常に完了しました。

vtbl 6 HRESULT GetDeviceName(LPWSTR* ppDeviceName)

仮想ディスクが存在するボリュームのデバイス名を返します。

ppDeviceName

LPWSTR*

out

ボリュームのデバイス名を格納する文字列を受け取る変数へのポインターです。

戻り値

戻り値	説明
S_OK	メソッドは正常に完了しました。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVdsVDisk "{1E062B84-E5E6-4B4B-8A25-67B81E8F13E8}"
#usecom global IVdsVDisk IID_IVdsVDisk "{}"
#comfunc global IVdsVDisk_Open           3 int,int,int,sptr
#comfunc global IVdsVDisk_GetProperties  4 var
#comfunc global IVdsVDisk_GetHostVolume  5 sptr
#comfunc global IVdsVDisk_GetDeviceName  6 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsVDisk "{1E062B84-E5E6-4B4B-8A25-67B81E8F13E8}"
#usecom global IVdsVDisk IID_IVdsVDisk "{}"
#comfunc global IVdsVDisk_Open           3 int,int,int,sptr
#comfunc global IVdsVDisk_GetProperties  4 sptr
#comfunc global IVdsVDisk_GetHostVolume  5 sptr
#comfunc global IVdsVDisk_GetDeviceName  6 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。