CM_Get_Version_Ex Funktion (cfgmgr32.h)

[Beginnend mit Windows 8 und Windows Server 2012 wurde diese Funktion veraltet und sollte nicht verwendet werden.]

Die funktion CM_Get_Version_Ex gibt Version 4.0 der Plug & 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 Maschinenziehpunkt 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 verläuft, wird die hauptrevisionsnummer im Byte mit hoher Reihenfolge und der nebengeordneten Revisionsnummer im Byte mit niedriger Reihenfolge zurückgegeben. Version 4.0 wird als 0x0400 zurückgegeben. Standardmäßig wird Version 4.0 von Microsoft Windows 2000 und höher 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.

Bemerkungen

Diese Funktion gibt Version 4.0 des Konfigurations-Managers zurück, um die Kompatibilität mit Version 4.0 und allen späteren Versionen des Konfigurations-Managers sicherzustellen und die Kompatibilität mit allen Anwendungen sicherzustellen, die Version 4.0 des Konfigurations-Managers erfordern.

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

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und späteren Betriebssystemen entfernt, damit Sie nicht auf Remotecomputer zugreifen können, wenn sie auf 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
Header cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Get_Version

CM_Is_Version_Available

CM_Is_Version_Available_Ex