Klasse __PARAMETERS
Die Systemklasse __PARAMETERS ist eine abstrakte Klasse, die die Eingabe- und Ausgabeparameter für Methoden definiert. Sie wird auch verwendet, um Eingabe- und Ausgabeparameterwerte zwischen einem WMI-Client und einem Methodenanbieter zu übergeben.
Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.
[abstract]
class __PARAMETERS
{
};
Die Klasse __PARAMETERS definiert keine Member.
Um eine Methode in einer Benutzerklasse zu definieren, erstellt ein WMI-Client eine Kopie der Klasse __PARAMETERS und fügt eine Eigenschaft für jeden Eingabeparameter in einer Methode hinzu. Wenn die Methode einen Rückgabewert oder Ausgabeparameter enthält, muss eine weitere Kopie von __PARAMETERS erstellt werden. Wenn die Methode einen Rückgabewert zurückgibt, muss der Client eine Eigenschaft mit dem Namen ReturnValue hinzufügen. Der Methodenanbieter speichert dann die Methodenparameter mit einem Aufruf von IWbemClassObject::PutMethod.
Um eine Methode aufzurufen, ruft ein Client nacheinander Folgendes auf:
- IWbemClassObject::GetMethod zum Abrufen einer Kopie der Klasse __PARAMETERS, die von IWbemClassObject::PutMethod gespeichert wird.
- IWbemClassObject::SpawnInstance, und legt dann eine Eigenschaft für jeden Eingabeparameter auf die Methode fest.
- IWbemServices::ExecMethod oder IWbemServices::ExecMethodAsync, um die Methode auszuführen.
Nachdem die Ausführung der Methode abgeschlossen ist, kann eine weitere Klasseninstanz __PARAMETERS zurückgegeben werden, wenn die Methode über Ausgabeparameter oder einen Rückgabewert verfügt.
- Wenn die Methode mit IWbemServices::ExecMethod aufgerufen wurde, wird die Instanz __PARAMETERS als Ausgabeargument zurückgegeben.
- Wenn die Methode mit IWbemServices::ExecMethodAsync aufgerufen wurde, wird die Instanz __PARAMETERS als Parameter für IWbemObjectSink::Indicate zurückgegeben.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
Windows Server 2008 |
Namespace |
Alle WMI-Namespaces |