CM_Get_Version_Ex-Funktion (cfgmgr32.h)

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

Die CM_Get_Version_Ex-Funktion gibt Version 4.0 des Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) für einen lokalen oder Remotecomputer zurück.

Syntax

CMAPI WORD CM_Get_Version_Ex(
  [in, optional] HMACHINE hMachine
);

Parameter

[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

Wenn die Funktion erfolgreich ist, gibt sie die Hauptrevisionsnummer im Byte mit hoher Ordnung und die nebenrevisionsnummer im Byte mit niedriger Reihenfolge zurück. Version 4.0 wird als 0x0400 zurückgegeben. Standardmäßig wird Version 4.0 von Microsoft Windows 2000 und höheren Versionen von Windows unterstützt. Wenn ein interner Fehler auftritt, gibt die Funktion 0x0000 zurück. Rufen Sie GetLastError auf, um den Fehlercode für den Fehler abzurufen.

Hinweise

Diese Funktion gibt Version 4.0 des Konfigurations-Managers zurück, um die Kompatibilität mit Version 4.0 und allen höheren Versionen des Konfigurations-Managers sicherzustellen und die Kompatibilität mit allen Anwendungen sicherzustellen, für die Version 4.0 des Konfigurations-Managers erforderlich ist.

Verwenden Sie CM_Is_Version_Available oder CM_Is_Version_Available_Ex, um festzustellen, ob eine bestimmte Version des Konfigurations-Managers auf einem Computer verfügbar ist.

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 Versionen von Windows ausgeführt werden.

Anforderungen

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_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex