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)

另请参阅

IWiaDrvItem

wiasCreateDrvItem