WSMAN_PLUGIN_SIGNAL Rückruffunktion (wsman.h)

Artikel
03/09/2024

Definiert den Signalrückruf für ein Plug-In. Diese Funktion wird aufgerufen, wenn ein eingehendes Signal von einem Clientaufruf empfangen wird.

Der DLL-Einstiegspunktname für diese Methode muss WSManPluginSignal sein.

Syntax

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

void WsmanPluginSignal(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD flags,
  [in]           PVOID shellContext,
  [in, optional] PVOID commandContext,
  [in]           PCWSTR code
)
{...}

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] shellContext

Gibt den Kontext an, der beim Erstellen der Shell empfangen wurde.

[in, optional] commandContext

Wenn diese Anforderung auf einen Befehl und nicht auf eine Shell ausgerichtet ist, ist dies der Kontext, der vom Winrm-Erstellungsvorgang zurückgegeben wird. Andernfalls ist dieser Parameter NULL.

[in] code

Gibt das Signal an, das vom Client empfangen wird. Die folgenden Codes sind üblich.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

Das Shell- oder Eingabeaufforderungsfenster wurde geschlossen. Das Plug-In sollte die WSManPluginOperationComplete-Funktion aufrufen.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Das Signal für STRG+C wurde empfangen, und der Prozess wurde angehalten. Das Plug-In sollte die WSManPluginOperationComplete-Funktion aufrufen.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Das Signal für STRG+BREAK wurde empfangen, und der Prozess wurde angehalten. Das Plug-In sollte die WSManPluginOperationComplete-Funktion aufrufen.

Rückgabewert

Keine

Bemerkungen

Ein Signal kann für die Verarbeitung einer STRG+C-Sequenz oder einer von vielen anderen Arten von benutzerdefinierten Signalen empfangen werden. Der Rückruf wird für jedes empfangene Signal einmal aufgerufen. Das Plug-In bestimmt, welche Signale dazu führen, dass Befehle und/oder Shells heruntergefahren werden. Da Signale shellspezifisch sind, muss das Plug-In das Herunterfahren initiieren, indem die WSManPluginOperationComplete-Methode aufgerufen wird. Für jeden Aufruf sollte das Plug-In WSManPluginOperationComplete aufrufen, um den Empfang zu bestätigen und das nächste Signal empfangen zu lassen.

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

Share via