IVMVirtualMachineEvents::OnRequestShutdown-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Empfängt eine Benachrichtigung, dass eine Herunterfahrensanforderung gestellt wurde.

Syntax

HRESULT OnRequestShutdown();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese Methode wird immer dann aufgerufen, wenn die Sitzung des virtuellen Computers heruntergefahren wird. Das Clientprogramm muss diese Schnittstellenmethode implementieren, um eine Benachrichtigung über das ereignis vmVirtualMachineEvent_RequestShutdown von IVMVirtualMachine zu erhalten.

Diese Ereignisbenachrichtigung wird nur gesendet, wenn die Sitzung der virtuellen Computer heruntergefahren wird. Betriebssystem-Herunterfahrroutinen wie IVMGuestOS::Shutdown lösen dieses Ereignis nicht direkt aus, es sei denn, sie versuchen auch, eine Softwareabschaltung der virtuellen Hardware durchzuführen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 DIID_IVMVirtualMachineEvents ist definiert als 9d84f560-bb67-4961-bd12-a4da780c67e4

Siehe auch

IVMVirtualMachineEvents