WSManRunShellCommand-Funktion (wsman.h)

Artikel
08/28/2023

Startet die Ausführung eines Befehls in einer vorhandenen Shell und wartet nicht auf den Abschluss des Befehls.

Syntax

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

Parameter

[in, out] shell

Gibt das Shellhandle an, das vom WSManCreateShell-Aufruf zurückgegeben wird. Dieser Parameter darf nicht NULL sein.

flags

Für die zukünftige Verwendung reserviert. Muss Null sein.

[in] commandLine

Definiert eine erforderliche NULL-endende Zeichenfolge, die den auszuführenden Befehl darstellt. In der Regel wird der Befehl ohne Argumente angegeben, die separat angegeben werden. Ein Benutzer kann jedoch die Befehlszeile und alle Argumente mithilfe dieses Parameters angeben. Wenn Argumente für den commandLine-Parameter angegeben werden, sollte der args-ParameterNULL sein.

[in, optional] args

Ein Zeiger auf eine WSMAN_COMMAND_ARG_SET-Struktur , die ein Array von Argumentwerten definiert, die bei der Erstellung an den Befehl übergeben werden. Wenn keine Argumente erforderlich sind, sollte dieser Parameter NULL sein.

[in, optional] options

Definiert eine Reihe von Optionen für den Befehl. Diese Optionen werden an den Dienst übergeben, um die Befehlsausführung zu ändern oder zu verfeinern. Dieser Parameter kann NULL sein. Weitere Informationen zu den Optionen finden Sie unter WSMAN_OPTION_SET.

[in] async

Definiert eine asynchrone Struktur. Die asynchrone Struktur enthält einen optionalen Benutzerkontext und eine obligatorische Rückruffunktion. Weitere Informationen finden Sie in der WSMAN_SHELL_ASYNC-Struktur . Dieser Parameter darf nicht NULL sein und sollte durch Aufrufen der WSManCloseCommand-Methode geschlossen werden.

[out] command

Definiert das Befehlsobjekt, das einem Befehl in einer Shell zugeordnet ist. Dieses Handle wird bei einem erfolgreichen Aufruf zurückgegeben und zum Senden und Empfangen von Daten sowie zum Signalisieren des Befehls verwendet. Dieses Handle sollte durch Aufrufen der WSManCloseCommand-Methode geschlossen werden. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Keine

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

Freigeben über