WSManPluginReceiveResult-Funktion (wsman.h)

Meldet Ergebnisse für den WSMAN_PLUGIN_RECEIVE-Plug-In-Aufruf und wird von den meisten Shell-Plug-Ins verwendet, die Ergebnisse zurückgeben. Nachdem alle Daten empfangen wurden, muss die WSManPluginOperationComplete-Methode aufgerufen werden.

Syntax

DWORD WSManPluginReceiveResult(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in, optional] PCWSTR               stream,
  [in, optional] WSMAN_DATA           *streamResult,
  [in, optional] PCWSTR               commandState,
  [in]           DWORD                exitCode
);

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

Für die zukünftige Verwendung reserviert. Muss auf 0 festgelegt werden.

[in, optional] stream

Gibt den Stream an, dem die Daten zugeordnet sind. Jeder Stream kann verwendet werden, aber die Standardstreams sind STDIN, STDOUT und STDERR.

[in, optional] streamResult

Ein Zeiger auf eine WSMAN_DATA-Struktur , die das Ergebnisobjekt angibt, das an den Client zurückgegeben wird. Das Ergebnis kann entweder im Binärformat oder im XML-Format vorliegen.

[in, optional] commandState

Gibt den Status des Befehls an. Dieser Parameter muss entweder auf einen der folgenden Werte oder auf einen vom Plug-In definierten Wert festgelegt werden.

WSMAN_RECEIVE_STATE_NONE

Der Vorgang erfordert keine Aktion.

WSMAN_RECEIVE_STATE_NORMAL_TERMINATION

Der Vorgang wurde normal beendet.

WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION

Der Vorgang wurde unerwartet beendet.

WSMAN_RECEIVE_STATE_WAITING

Der Vorgang wartet auf die Eingabe.

WSMAN_RECEIVE_STATE_INPUT_REQUIRED

Für den Vorgang ist eine Befehlszeileneingabe erforderlich.

[in] exitCode

Wird in allen Fällen ignoriert, außer wenn commandStateentweder WSMAN_RECEIVE_STATE_NORMAL_TERMINATION oder WSMAN_RECEIVE_STATE_ABNORMAL_TERMINATION ist. Jedes Ergebnis kann separate Fehlercodes aufweisen. Wenn beim Befehl oder Stream ein Fehler aufgetreten ist, muss das Plug-In die WSManPluginOperationComplete-Methode aufrufen.

Rückgabewert

Keine

Anforderungen