Win32 API 日本語リファレンス
ホーム › Storage.EnhancedStorage › IEnhancedStorageACT2

IEnhancedStorageACT2

COM
📘 Microsoft Learn (日本語) · English
IID4da57d2e-8eb3-41f6-a07e-98b52b88242b継承元IEnhancedStorageACT自前メソッド開始 vtbl9

公式ドキュメント

IEnhancedStorageACT2 インターフェイスは、1667 Addressable Contact Target (ACT) に関する情報を取得するために使用します。

メソッド 2

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

vtbl 9 HRESULT GetDeviceName(LPWSTR* ppwszDeviceName)

IEnhancedStorageACT2::GetDeviceName メソッドは、Addressable Command Target (ACT) に関連付けられたデバイス名を返します。

ppwszDeviceNameLPWSTR*outACT に関連付けられたデバイス名を表す文字列へのポインター。

戻り値

このメソッドは、次の値のいずれかを返します。

戻り値 説明
S_OK
 関連付けられたボリュームが正常に返されました。
E_INVALIDARG
 ppwszDeviceName が NULL です。
E_OUTOFMEMORY
 メモリの割り当てが不足したため、操作は失敗しました。

解説(Remarks)

デバイス名の文字列を格納するメモリは Enhanced Storage API によって割り当てられます。返されたポインターを CoTaskMemFree に渡して解放する必要があります。

vtbl 10 HRESULT IsDeviceRemovable(BOOL* pIsDeviceRemovable)

IEnhancedStorageACT2::IsDeviceRemovable メソッドは、ACT に関連付けられたデバイスがリムーバブルかどうかを示す情報を返します。

pIsDeviceRemovableBOOL*outACT に関連付けられたデバイスがリムーバブルかどうかを示すブール値へのポインター。

戻り値

このメソッドは、次の値のいずれかを返します。

戻り値 説明
S_OK
 情報が正常に取得されました。
E_INVALIDARG
 pIsDeviceRemovable が NULL です。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IEnhancedStorageACT2 "{4DA57D2E-8EB3-41F6-A07E-98B52B88242B}"
#usecom global IEnhancedStorageACT2 IID_IEnhancedStorageACT2 "{AF076A15-2ECE-4AD4-BB21-29F040E176D8}"
#comfunc global IEnhancedStorageACT2_GetDeviceName      9 var
#comfunc global IEnhancedStorageACT2_IsDeviceRemovable  10 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。