IPortableDeviceManager::GetDeviceManufacturer 方法 (portabledeviceapi.h)
检索设备制造商的名称。
语法
HRESULT GetDeviceManufacturer(
[in] LPCWSTR pszPnPDeviceID,
[in, out] WCHAR *pDeviceManufacturer,
[in, out] DWORD *pcchDeviceManufacturer
);
参数
[in] pszPnPDeviceID
指向以 null 结尾的字符串的指针,该字符串包含设备的即插即用 ID。 可以通过调用 GetDevices 检索连接到计算机的所有设备的即插即用名称的列表。
[in, out] pDeviceManufacturer
调用方分配的缓冲区,用于保存设备制造商的名称。 若要了解此参数所需的大小,请先调用此方法,并将此参数设置为 NULL , 并将 pcchDeviceManufacturer 设置为 0;方法将成功,并将 pcchDeviceManufacturer 设置为保存设备友好名称(包括终止字符)所需的缓冲区大小。
[in, out] pcchDeviceManufacturer
输入时, pDeviceManufacturer 可以容纳的最大字符数,不包括终止字符。 输出时, pDeviceManufacturer 返回的字符数,不包括终止字符。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
提供的缓冲区不够大,无法容纳设备说明。 (请参考 pcchDeviceDescription 中返回的所需 size 的值。) |
|
找不到设备说明。 |
|
方法成功。 |
|
至少一个必需的参数是 NULL 指针。 |
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |