Freigeben über


CM_Is_Version_Available_Ex-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet und sollte nicht verwendet werden.]

Die CM_Is_Version_Available_Ex-Funktion gibt an, ob eine angegebene Version des Plug & Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) von einem lokalen oder einem Remotecomputer unterstützt wird.

Syntax

CMAPI BOOL CM_Is_Version_Available_Ex(
  [in]           WORD     wVersion,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] wVersion

Gibt eine Version des Konfigurations-Managers an. Die unterstützte Version des Konfigurations-Managers entspricht direkt der Betriebssystemversion. Die Hauptversion wird durch das Byte mit hoher Reihenfolge und die Nebenversion durch das Byte mit niedriger Reihenfolge angegeben. Beispielsweise gibt 0x0400 Version 4.0 an, die standardmäßig von Microsoft Windows NT 4.0 und höheren Versionen von Windows unterstützt wird. Version 0x0501 gibt Version 5.1 an, die von Windows XP und höheren Versionen von Windows unterstützt wird.

[in, optional] hMachine

Stellt einen Computerhandle bereit, der von CM_Connect_Machine zurückgegeben wird.

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

Die Funktion gibt TRUE zurück, wenn die Funktion eine Verbindung mit dem angegebenen Computer herstellen kann und der Computer die angegebene Version unterstützt. Andernfalls gibt die Funktion FALSE zurück.

Hinweise

Verwenden Sie diese Funktion, um zu ermitteln, ob eine angegebene Version des Konfigurations-Managers von einem lokalen oder einem Remotecomputer unterstützt wird. Wenn die angegebene Version unterstützt wird, werden alle früheren Versionen und einschließlich dieser Version vom Computer unterstützt. Sie können auch CM_Is_Version_Available verwenden, um zu bestimmen, ob der lokale Computer eine bestimmte Version des Konfigurations-Managers unterstützt.

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 Windows XP und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available