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

функция CM_Get_Device_Interface_Property_ExW (cfgmgr32.h)

  • Статья

[Начиная с Windows 8 и Windows Server 2012 эта функция устарела. Вместо этого используйте CM_Get_Device_Interface_Property .]

Функция CM_Get_Device_Interface_Property_ExW извлекает свойство устройства, заданное для интерфейса устройства.

Синтаксис

CMAPI CONFIGRET CM_Get_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Параметры

[in] pszDeviceInterface

Указатель на строку, определяющую экземпляр интерфейса устройства, из которого извлекается свойство.

[in] PropertyKey

Указатель на структуру DEVPROPKEY , представляющую ключ свойства интерфейса устройства извлекаемого свойства интерфейса устройства.

[out] PropertyType

Указатель на переменную типа DEVPROPTYPE, которая получает идентификатор типа property-data-type запрошенного свойства интерфейса устройства. Идентификатор типа property-data-type представляет собой побитовое или между идентификатором базового типа данных и модификатором property-data-type, если изменяется базовый тип данных.

[out] PropertyBuffer

Указатель на буфер, который получает запрошенное свойство интерфейса устройства. CM_Get_Device_Interface_Property_ExW извлекает запрошенное свойство, только если буфер достаточно велик для хранения всех данных значения свойства. Указатель может иметь значение NULL.

[in, out] PropertyBufferSize

Размер буфера PropertyBuffer в байтах. Если свойство PropertyBuffer имеет значение NULL, значение *PropertyBufferSize должно быть равно нулю. В качестве выходных данных, если буфер недостаточно велик для хранения всех данных значения свойства, CM_Get_Device_Interface_Property_ExW возвращает размер данных в байтах в *PropertyBufferSize.

[in] ulFlags

Зарезервировано. Необходимо задать нулевое значение.

[in, optional] hMachine

Дескриптор компьютера, предоставленный вызывающим абонентом, полученный при предыдущем вызове CM_Connect_Machine.

Примечание Использование этой функции для доступа к удаленным компьютерам не поддерживается, начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.
 

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

Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.

Комментарии

CM_Get_Device_Interface_Property_ExW является частью единой модели свойств устройства.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 10 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть cfgmgr32.h (включая Cfgmgr32.h)
Библиотека Cfgmgr32.lib
DLL CfgMgr32.dll

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

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty