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