WSMAN_PLUGIN_COMMAND Rückruffunktion (wsman.h)

Artikel
03/13/2024

Definiert den Befehlsrückruf für ein Plug-In. Diese Funktion wird aufgerufen, wenn eine Anforderung für einen Befehl empfangen wird. Alle Windows-Remoteverwaltungs-Plug-Ins, die Shellvorgänge unterstützen und Befehle erstellen müssen, müssen diesen Rückruf implementieren.

Der Name des DLL-Einstiegspunkts muss WSManPluginCommand sein.

Syntax

WSMAN_PLUGIN_COMMAND WsmanPluginCommand;

void WsmanPluginCommand(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PCWSTR commandLine,
  WSMAN_COMMAND_ARG_SET *arguments
)
{...}

Parameter

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.

flags

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

shellContext

Gibt den Kontext an, der vom Erstellen der Shell zurückgegeben wird, der dieser Befehl zugeordnet werden muss.

commandLine

Gibt die auszuführende Befehlszeile an.

arguments

Ein Zeiger auf eine WSMAN_COMMAND_ARG_SET-Struktur , die die Befehlszeilenargumente angibt, die an den Befehl übergeben werden sollen.

Rückgabewert

Keine

Bemerkungen

Das WinRM-Plug-In (WinRM) ruft die WSManPluginReportContext-Methode auf, um einen Befehlskontext für den Befehl zu registrieren. Alle Vorgänge für diesen Befehl werden an diesen Kontext übergeben. Der Kontext muss gültig sein, bis die WSManPluginOperationComplete-Methode vom Plug-In aufgerufen wird, um anzugeben, dass entweder der Befehl abgeschlossen oder die Shell heruntergefahren wurde. Alle übergebenen Parameter sind gültig, bis das WinRM-Plug-In WSManPluginOperationComplete aufruft.

Anforderungen

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

Share via