IWiaDrvItem::GetFullItemName 方法 (wiamindr_lh.h)

IWiaDrvItem::GetFullItemName 方法获取项的完整名称,包括路径信息。

语法

HRESULT GetFullItemName(
  BSTR *__MIDL__IWiaDrvItem0002
);

参数

__MIDL__IWiaDrvItem0002

pbstrFullItemName [out, 可选]

指向一个内存位置,该位置将接收包含该项全名的字符串的地址。

返回值

如果方法成功,它会将指针存储在 pbstrFullItemName 中指向项的完整名称(包括路径信息)并返回 S_OK。 如果该方法由于内存不足而未能分配字符串,则返回 E_OUTOFMEMORY。 如果参数 pbstrFullItemName 无效,该方法将返回 E_INVALIDARG。 如果方法因其他原因而失败,则返回标准 COM 错误代码。

注解

如果有足够的内存可用,此方法将分配包含当前项的完整名称(包括路径信息)的字符串。 该方法返回指向 pbstrFullItemName 中的字符串的指针。 微型驱动程序必须通过调用 SysFreeString 函数解除分配字符串使用的内存。

pbstrFullItemName 中返回的名称是当驱动程序服务库函数 wiasCreateDrvItem 首次创建项时与项关联的名称。

要求

   
目标平台 桌面
Header wiamindr_lh.h (包括 Wiamindr.h)

请参阅

IWiaDrvItem

wiasCreateDrvItem