IVmApplicationHealthMonitor::SetApplicationState-Methode

Legt den Integritätsstatus einer Anwendung fest, die auf einem virtuellen Computer ausgeführt wird.

Syntax

HRESULT SetApplicationState(
  [in] BSTR              Id,
  [in] BSTR              Name,
  [in] APPLICATION_STATE State
);

Parameter

ID [in]

Eine BSTR-Darstellung der GUID , die die Anwendung identifiziert. Es liegt in der Verantwortung der aufrufenden Anwendung, die Bezeichner zu erstellen und zu verwalten, die sie für die überwachten Anwendungen verwendet.

Name [in]

Der Anzeigename der Anwendung. Dieser Name wird in einem Informationsereignisprotokolleintrag für die Zustandsänderung verwendet.

Staat [in]

Ein Wert der APPLICATION_STATE-Enumeration , die den neuen Integritätsstatus der Anwendung angibt.

Rückgabewert

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

Bemerkungen

Der Zustand der Anwendungen, die auf dem virtuellen Computer ausgeführt werden, wird im Eigenschaftswert OperationalStatus[1] der Msvm_HeartbeatComponent-Klasse widerspiegelt.

Um dieses Programmierelement verwenden zu können, muss die Windows 8 Integrationskomponenten auf dem virtuellen Computer installiert sein, auf dem die Anwendung ausgeführt wird.

Anforderungen

Siehe auch

IVmApplicationHealthMonitor