Freigeben über


WSManPluginGetOperationParameters-Funktion (wsman.h)

Ruft Betriebsinformationen für Elemente ab, z. B. Timeouts und Dateneinschränkungen, die dem Vorgang zugeordnet sind. Ein Plug-In sollte diese Parameter nur zu Informationszwecken verwenden.

Syntax

DWORD WSManPluginGetOperationParameters(
  [in]  WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]  DWORD                flags,
  [out] WSMAN_DATA           *data
);

Parameter

[in] requestDetails

Ein Zeiger auf eine WSMAN_PLUGIN_REQUEST-Struktur , die den Ressourcen-URI, die Optionen, das Gebietsschema, das Shutdown-Flag und das Handle für die Anforderung angibt.

[in] flags

Gibt die Optionen an, die für den Abruf verfügbar sind. Dieser Parameter muss entweder auf einen der folgenden Werte oder auf einen durch das Plug-In definierten Wert festgelegt werden.

WSMAN_PLUGIN_PARAMS_MAX_ENVELOPE_SIZE (1)

Gibt die maximale Größe des Vorgangsantwortpakets an. Die Größe umfasst die Größe der Daten zusammen mit dem SOAP-Mehraufwand (Simple Object Access Protocol).

Hinweis Einige Vorgänge verfügen über einen einzelnen Aufruf des Plug-Ins, der dazu führen kann, dass mehrere Roundtrips auftreten. Wenn beim Aufrufen dieser Methode keine Anforderungen auf Daten warten, wird die maximale Umschlaggröße für das vorherige Paket angegeben.
 

WSMAN_PLUGIN_PARAMS_TIMEOUT (2)

Gibt das Timeout des aktuellen Vorgangs an.

Hinweis Einige Vorgänge verfügen über einen einzelnen Aufruf des Plug-Ins, der dazu führen kann, dass mehrere Roundtrips auftreten. Wenn beim Aufrufen dieser Methode keine Anforderungen auf Daten warten, wird das Timeout für das vorherige Paket angegeben.
 

WSMAN_PLUGIN_PARAMS_REMAINING_RESULT_SIZE (3)

Gibt an, wie viel Speicherplatz für Daten für den aktuellen Vorgang übrig bleibt. Die Größe basiert auf dem Vorgangstyp. Beispielsweise würde dieses Flag angeben, wie groß das einzelne Ergebniselement für einen Get-Vorgang sein kann. Bei Enumerationen nimmt die Größe ab, nachdem jedes Objekt hinzugefügt wurde. Nachdem das aktuelle Paket mit Enumerationen und Get-Vorgängen gefüllt wurde, wird es an den Client zurückgegeben, obwohl mehr Daten akzeptiert und zwischengespeichert werden.

Hinweis Einige Vorgänge verfügen über einen einzelnen Aufruf des Plug-Ins, der dazu führen kann, dass mehrere Roundtrips auftreten. Wenn beim Aufrufen dieser Methode keine Anforderungen auf Daten warten, wird die verbleibende Größe für ein zwischengespeichertes Element angegeben.
 

WSMAN_PLUGIN_PARAMS_LARGEST_RESULT_SIZE (4)

Gibt die maximale Größe der Daten für den aktuellen Vorgang an.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_LOCALE (5)

Gibt das Sprachgebietsschema an, das vom Client für den Vorgang angefordert wurde.

WSMAN_PLUGIN_PARAMS_GET_REQUESTED_DATA_LOCALE (6)

Gibt das Sprachgebietsschema der Daten an, die vom Client angefordert wurden.

[out] data

Ein Zeiger auf eine WSMAN_DATA-Struktur , die das Ergebnisobjekt angibt.

Rückgabewert

Die Methode gibt NO_ERROR zurück, wenn sie erfolgreich war. Andernfalls wird ein Fehlercode zurückgegeben. Im Folgenden finden Sie die häufigsten Fehlercodes:

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Zielplattform Windows
Kopfzeile wsman.h
Bibliothek WsmSvc.lib
DLL WsmSvc.dll
Verteilbare Komponente Windows Management Framework unter Windows Server 2008 mit SP2 und Windows Vista mit SP2