IWiaDrvItem::GetFullItemName 方法 (wiamindr_lh.h)
IWiaDrvItem::GetFullItemName 方法會取得專案的完整名稱,包括路徑資訊。
語法
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
參數
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, optional]
指向將接收包含專案完整名稱之字串位址的記憶體位置。
傳回值
如果方法成功,它會在 pbstrFullItemName 中儲存專案完整名稱的指標,包括路徑資訊,並傳回 S_OK。 如果方法因為記憶體不足而無法配置字串,則會 傳回E_OUTOFMEMORY。 如果 pbstrFullItemName 參數無效,方法會 傳回E_INVALIDARG。 如果方法因其他原因而失敗,則會傳回標準 COM 錯誤碼。
備註
如果有足夠的記憶體可用,這個方法會配置包含目前專案完整名稱的字串,包括路徑資訊。 方法會傳回 pbstrFullItemName 中字串的指標。 minidriver 必須藉由呼叫 SysFreeString 函式來解除分配字串所使用的記憶體。
pbstrFullItemName 中傳回的名稱是驅動程式服務連結庫函式 wiasCreateDrvItem 第一次建立專案時,與專案相關聯的名稱。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | wiamindr_lh.h (包含 Wiamindr.h) |