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 中字符串的指针。 微型驱动程序必须通过调用 SysFreeString 函数解除分配字符串使用的内存。
pbstrFullItemName 中返回的名称是驱动程序服务库函数 wiasCreateDrvItem 首次创建该项时与该项关联的名称。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | wiamindr_lh.h (包括 Wiamindr.h) |