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