WSManPluginOperationComplete-Funktion (wsman.h)

  • Artikel

Meldet den Abschluss eines Vorgangs durch alle Vorgangseinstiegspunkte mit Ausnahme der Methoden WSManPluginStartup und WSManPluginShutdown .

Syntax

DWORD WSManPluginOperationComplete(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD                flags,
  [in]           DWORD                errorCode,
  [in, optional] PCWSTR               extendedInformation
);

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 Null sein.

[in] errorCode

Meldet jeden Fehler im Vorgang. Wenn dieser Parameter nicht NO_ERROR ist, werden alle nicht gesendeten Ergebnisdaten verworfen, und der Fehler wird gesendet.

[in, optional] extendedInformation

Gibt ein XML-Dokument an, das zusätzliche Fehlerinformationen enthält, die an den Client gemeldet werden müssen. Dieser Parameter wird ignoriert, wenn errorCodeNO_ERROR ist. Die Sprache der Benutzeroberfläche des Threads sollte für die Lokalisierung verwendet werden.

Rückgabewert

Die Methode gibt NO_ERROR zurück, wenn sie erfolgreich war. Andernfalls wird ein Fehlercode zurückgegeben. Wenn der Vorgang nicht erfolgreich ist, muss das Plug-In den aktuellen Vorgang beenden und alle diesem Vorgang zugeordneten Daten sauber. Die requestDetails-Struktur ist ungültig, wenn ein Fehler empfangen wird, und darf nicht an eine andere WinRM-Methode (WinRM) übergeben werden.

Hinweise

Die WSManPluginOperationComplete-Funktion wird verwendet, um den Abschluss des Datenstroms für WSManPluginReceive zu melden. Die Vorgänge WSManPluginShell und WSManPluginCommand müssen diese Funktion auch aufrufen, wenn die Shell- und Befehlsvorgänge abgeschlossen sind.

Anforderungen

   
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, Windows Vista mit SP1 und Windows Vista mit SP2