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.
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 |