Freigeben über


CM_Is_Dock_Station_Present_Ex-Funktion (cfgmgr32.h)

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Is_Dock_Station_Present .]

Die CM_Is_Dock_Station_Present_Ex-Funktion identifiziert, ob eine Dockingstation auf einem lokalen oder einem Remotecomputer vorhanden ist.

Syntax

CMAPI CONFIGRET CM_Is_Dock_Station_Present_Ex(
  [out]          PBOOL    pbPresent,
  [in, optional] HMACHINE hMachine
);

Parameter

[out] pbPresent

Zeiger auf einen booleschen Wert, der angibt, ob eine Dockingstation auf einem lokalen Computer vorhanden ist. Die Funktion legt *pbPresent auf TRUE fest, wenn eine Dockingstation vorhanden ist. Die Funktion legt *pbPresent auf FALSE fest, wenn die Funktion keine Verbindung mit dem angegebenen Computer herstellen kann oder keine Dockingstation vorhanden ist.

[in, optional] hMachine

Stellt einen Maschinenhandle 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 der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls gibt die Funktion einen der CR_-Präfix-Fehlercodes zurück, die in Cfgmgr32.h definiert sind.

Hinweise

Verwenden Sie diese Funktion, um zu bestimmen, ob eine Dockingstation auf einem lokalen oder einem Remotecomputer vorhanden ist. Sie können auch die folgenden zugehörigen Funktionen mit Dockingstationen verwenden:

  • CM_Is_Dock_Station_Present gibt an, ob eine Dockingstation auf einem lokalen Computer vorhanden ist.

  • CM_Request_Eject_PC fordert, dass ein tragbarer PC, der in eine lokale Dockingstation eingefügt wird, ausgeworfen wird.

  • CM_Request_Eject_PC_Ex fordert an, dass ein tragbarer PC, der in eine lokale oder eine Remote-Dockingstation eingefügt wird, ausgeworfen wird.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und späteren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn Sie unter diesen Versionen von Windows ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex