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

Статья
08/22/2023

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

Функция CM_Set_DevNode_Property_ExW задает свойство экземпляра устройства.

Синтаксис

CMAPI CONFIGRET CM_Set_DevNode_Property_ExW(
  [in]           DEVINST          dnDevInst,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in]           const PBYTE      PropertyBuffer,
  [in]           ULONG            PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Параметры

[in] dnDevInst

Дескриптор экземпляра устройства, привязанный к локальному компьютеру.

[in] PropertyKey

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

[in] PropertyType

Значение типа DEVPROPTYPE, представляющее идентификатор типа property-data-type для свойства экземпляра устройства. Чтобы удалить свойство, ей необходимо присвоить значение DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Указатель на буфер, содержащий значение свойства экземпляра устройства. Если свойство или данные удаляются, для этого указателя необходимо задать значение NULL, а для свойства PropertyBufferSize — нулевое значение.

[in] PropertyBufferSize

Размер буфера PropertyBuffer в байтах. Если свойство PropertyBuffer имеет значение NULL, свойство PropertyBufferSize должно иметь нулевое значение.

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

Требования

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

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

CM_Connect_Machine

SetupDiSetDeviceProperty

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