CM_Set_DevNode_Problem_Ex-Funktion (cfgmgr32.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Set_DevNode_Problem .]

Die CM_Set_DevNode_Problem_Ex-Funktion legt einen Problemcode für ein Gerät fest, das auf einem lokalen computer oder einem Remotecomputer installiert ist.

Syntax

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

Parameter

[in] dnDevInst

Das vom Anrufer bereitgestellte Gerät instance Handle, das an den von hMachine bereitgestellten Maschinenhandle gebunden ist.

[in] ulProblem

Stellt einen Problemcode bereit, der null oder eines der CM_PROB_Xxx Flags ist, die in Geräte-Manager Fehlermeldungen beschrieben werden. Der Wert null gibt an, dass kein Problemcode für das Gerät festgelegt ist.

[in] ulFlags

Muss auf 0 festgelegt werden.

[in, optional] hMachine

Vom Aufrufer bereitgestelltes Computerhandle, an das das vom Aufrufer bereitgestellte Gerät instance Handle gebunden ist.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
 

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der CR_-Präfix-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.

Hinweise

Verwenden Sie diese Funktion, um einen Problemcode für ein Gerät festzulegen, das auf einem lokalen computer oder einem Remotecomputer installiert ist. Sie können auch die folgenden Funktionen verwenden, um den Problemcode eines Geräts festzulegen und den Problemcodesatz für das Gerät abzurufen:

  • CM_Get_DevNode_Status gibt den Problemcodesatz für ein Gerät zurück, das auf einem lokalen Computer installiert ist.

  • CM_Get_DevNode_Status_Ex gibt den Problemcodesatz für ein Gerät zurück, das auf einem lokalen computer oder einem Remotecomputer installiert ist.

  • CM_Set_DevNode_Problem legt einen Problemcode für ein Gerät fest, das auf einem lokalen Computer installiert ist.

Informationen zur Verwendung von Gerätehandles instance, die an einen lokalen oder Remotecomputer gebunden sind, finden Sie unter CM_Get_Child_Ex.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und höheren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Windows-Versionen ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Get_Child_Ex

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Set_DevNode_Problem