WSManSignalShell-Funktion (wsman.h)

Artikel
03/04/2024

Sendet einen Steuerelementcode an einen vorhandenen Befehl oder an die Shell selbst.

Syntax

void WSManSignalShell(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 code,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *signalOperation
);

Parameter

[in] shell

Gibt das von einem WSManCreateShell-Aufruf zurückgegebene Handle an. Dieser Parameter darf nicht NULL sein.

[in, optional] command

Gibt das Befehlshandle an, das von einem WSManRunShellCommand-Aufruf zurückgegeben wird. Wenn dieser Wert NULL ist, wird der Signalcode an die Shell gesendet.

flags

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

[in] code

Gibt den Signalcode an, der an den Befehl oder die Shell gesendet werden soll. Die folgenden Codes sind üblich.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

Das Shell- oder Eingabeaufforderungsfenster wurde geschlossen.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Das Signal für STRG+C wurde empfangen, und der Prozess wurde angehalten.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Das Signal für STRG+BREAK wurde empfangen, und der Prozess wurde angehalten.

[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 WSManCloseOperation-Methode geschlossen werden.

[out] signalOperation

Definiert den Vorgangshandle für den Signalvorgang. Dieser Handle wird von einem erfolgreichen Aufruf der Funktion zurückgegeben und kann verwendet werden, um den Signalvorgang asynchron abzubrechen. Dieses Handle sollte durch Aufrufen der WSManCloseOperation-Methode geschlossen werden. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Keine

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

Freigeben über