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


Метод IPortableDevice::GetPnPDeviceID (portabledeviceapi.h)

Метод GetPnPDeviceID извлекает идентификатор устройства Plug and Play (PnP), который приложение использовало для открытия устройства.

Синтаксис

HRESULT GetPnPDeviceID(
  [out] LPWSTR *ppszPnPDeviceID
);

Параметры

[out] ppszPnPDeviceID

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

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.
E_WPD_DEVICE_NOT_OPEN
Метод IPortableDevice::Open еще не был вызван для этого устройства.

Комментарии

После завершения работы приложения с помощью строки, возвращаемой этим методом, оно должно вызвать функцию CoTaskMemFree , чтобы освободить строку.

Аргумент ppszPnPDeviceID не должен иметь значение NULL.

Требования

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

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

Интерфейс IPortableDevice

IPortableDevice::Open