Метод IPortableDeviceManager::GetDeviceManufacturer (portabledeviceapi.h)

Статья
03/01/2024

Извлекает имя изготовителя устройства.

Синтаксис

HRESULT GetDeviceManufacturer(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceManufacturer,
  [in, out] DWORD   *pcchDeviceManufacturer
);

Параметры

[in] pszPnPDeviceID

Указатель на строку, завершающуюся значением NULL, которая содержит идентификатор Plug and Play устройства. Список Plug and Play имен всех устройств, подключенных к компьютеру, можно получить, вызвав Метод GetDevices.

[in, out] pDeviceManufacturer

Буфер, выделенный вызывающим объектом, в котором хранится имя изготовителя устройства. Чтобы узнать требуемый размер для этого параметра, сначала вызовите этот метод с параметром NULL , а pcchDeviceManufacturer — 0; Метод будет выполнен успешно и присвоит pcchDeviceManufacturer необходимый размер буфера для хранения понятного для устройства имени, включая символ завершения.

[in, out] pcchDeviceManufacturer

При входе максимальное количество символов, которое может содержать pDeviceManufacturer , не включая символ завершения. В выходных данных — количество символов, возвращаемых pDeviceManufacturer, не включая символ завершения.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Предоставленный буфер недостаточно велик для хранения описания устройства. (Требуемый размер см. в описании значения, возвращаемого в pcchDeviceDescription .)
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	Не удалось найти описание устройства.
S_OK	Метод выполнен успешно.
E_POINTER	По крайней мере один из обязательных аргументов был пустым указателем.

Требования

Требование	Значение
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

См. также раздел

Интерфейс IPortableDeviceManager

IPortableDeviceManager::GetDevices

Поделиться через