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

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

  • Статья

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

Функция CM_Set_DevNode_Problem_Ex задает код проблемы для устройства, установленного на локальном или удаленном компьютере.

Синтаксис

CMAPI CONFIGRET CM_Set_DevNode_Problem_Ex(
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulProblem,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Параметры

[in] dnDevInst

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

[in] ulProblem

Предоставляет код проблемы, который равен нулю или одному из флагов CM_PROB_Xxx, описанных в диспетчер устройств сообщения об ошибках. Нулевое значение указывает, что код проблемы не задан для устройства.

[in] ulFlags

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

[in, optional] hMachine

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

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

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

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

Комментарии

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

  • CM_Get_DevNode_Status возвращает набор кода проблемы для устройства, установленного на локальном компьютере.

  • CM_Get_DevNode_Status_Ex возвращает набор кода проблемы для устройства, установленного на локальном или удаленном компьютере.

  • CM_Set_DevNode_Problem задает код проблемы для устройства, установленного на локальном компьютере.

Сведения об использовании дескрипторов экземпляров устройства, привязанных к локальному или удаленному компьютеру, см. в разделе CM_Get_Child_Ex.

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

Требования

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

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

CM_Get_Child_Ex

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Set_DevNode_Problem