ControlSampleTimes-Methode der CIM_MetricService-Klasse
Ermöglicht es, die Angabe der Zeitpunktmetriksammlung zu starten und die bevorzugte Stichprobenintervallzeit für die regelmäßige Datensammlung anzugeben.
Wenn das Sampling für zusätzliche Metriken gestartet wird, können die von dieser Methode angegebenen Einstellungen verwendet werden.
Syntax
uint32 ControlSampleTimes(
[in] datetime StartSampleTime,
[in] datetime PreferredSampleInterval,
[in] boolean RestartGathering
);
Parameter
-
StartSampleTime [in]
-
Zeitpunkt, zu dem das Sampling für die Metriken gestartet werden soll.
Der Wert 999901000000,000000+000 gibt an, dass die Stichprobenentnahme bei der nächsten Synchronisierung mit der vollen Stunde beginnen sollte. Die Stichprobenentnahme wird mit der ganzen Stunde synchronisiert, wenn sekunden seit Mitternacht das Modulo-Beispielintervall in Sekunden gleich 0 ist.
-
PreferredSampleInterval [in]
-
Bevorzugte Beispielintervallzeit. Um korrelierbare Metriken zu erhalten, empfiehlt es sich, das Beispielintervall so zu wählen, dass die Stichprobenintervallzeit von 3600 Modulo in Sekunden gleich 0 ist.
Es liegt in der Verantwortung der CIM-Metrikdienstimplementierung zu entscheiden, ob die angeforderte Beispielintervallzeit berücksichtigt wird.
Der CIM-Client kann überprüfen, ob die Metrikanbieter die angeforderte Beispielintervallzeit einhalten, indem verknüpfte BaseMetricDefinition-Instanzen abgerufen und der Inhalt der CIM_BaseMetricDefinition überprüft wird. SampleInterval-Eigenschaft .
-
RestartGathering [in]
-
TRUE , um anzufordern, dass das Sammeln aller Metriken, die dem Metrikdienst zugeordnet sind, mit diesem Methodenaufruf neu gestartet wird.
Rückgabewert
Gibt bei Erfolg eine 0 zurück; Gibt andernfalls einen Fehler zurück.
-
Erfolg (0)
-
Nicht unterstützt (1)
-
Fehler (2)
-
Reservierte Methode (..)
-
Herstellerspezifisch (32768..65535)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8.1 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 R2 |
| Namespace |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|