Команда WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION

Команда WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION извлекает идентификаторы объектов папок, которые могут содержать объект указанного типа. Эта команда предоставляется как более быстрый способ определить, где устройство хранит определенные объекты, чем при перечислении объектов методом подбора.

Категория команды

WPD_CATEGORY_DEVICE_HINTS

Параметры

Драйвер ожидает следующие параметры.

Параметр	VarType	Описание
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE	VT_CLSID	Обязательный. Тип объекта, для который вызывающий объект хочет найти контейнер. Например, чтобы найти папки верхнего уровня, используемые для хранения изображений на цифровой камере, вызывающий объект отправляет WPD_CONTENT_TYPE_IMAGE. Список типов объектов, определенных переносными устройствами Windows, см. в разделе Требования для объектов .

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

Драйвер должен вернуть следующие результаты.

Результат	VarType	Описание
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS	VT_UNKNOWN	Обязательный. IPortableDevicePropVariantCollection типа VT_LPWSTR значения, указывающие идентификаторы объектов папок, содержащих объекты типа, указанного вызывающим параметром. Если папки не найдены, это должен быть пустой список. Папки, указанные результатом, могут содержать объекты других типов контента или не содержать их. Сведения об ограничениях папок см. в свойстве WPD_FOLDER_CONTENT_TYPES_ALLOWED .
WPD_PROPERTY_COMMON_HRESULT	VT_ERROR	Обязательный. HRESULT, указывающий на успешное или неудачное выполнение команды. Если вызывающий объект выполняет недопустимый запрос, драйвер должен возвращать HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) и не должен возвращать другие значения результатов. Коды ошибок включают коды ошибок переносных устройств Windows или любые другие соответствующие коды ошибок.
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE	VT_UI4	Необязательный элемент. Код ошибки драйвера. Обычно это используется только для тестирования драйвера или, если драйвер, устройство и клиент разработаны вместе.

Вызов методов

Может вызываться только непосредственно с помощью IPortableDevice::SendCommand.

Требования

Требование	Значение
Заголовок	PortableDevice.h