WSMAN_PLUGIN_SHELL Rückruffunktion (wsman.h)

Definiert den Shellrückruf für ein Plug-In. Diese Funktion wird aufgerufen, wenn eine Anforderung für eine neue Shell empfangen wird. Alle Windows-Remoteverwaltungs-Plug-Ins, die Shellvorgänge unterstützen, müssen diesen Rückruf implementieren.

Der Name des DLL-Einstiegspunkts muss WSManPluginShell sein.

Syntax

WSMAN_PLUGIN_SHELL WsmanPluginShell;

VOID WsmanPluginShell(
  PVOID pluginContext,
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  WSMAN_SHELL_STARTUP_INFO *startupInfo,
  WSMAN_DATA *inboundShellInformation
)
{...}

Parameter

pluginContext

Gibt den Kontext an, der von einem Aufruf der WSManPluginStartup-Methode zurückgegeben wurde. Dieser Parameter stellt eine bestimmte Anwendungsinitialisierung eines WinRM-Plug-Ins dar.

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.

startupInfo

Ein Zeiger auf eine WSMAN_SHELL_STARTUP_INFO-Struktur , die Startinformationen für die Shell enthält.

inboundShellInformation

Ein Zeiger auf eine WSMAN_DATA-Struktur , die ein optionales eingehendes Objekt angibt, das zusätzliche Daten für die Shell enthält.

Rückgabewert

Keine

Bemerkungen

Das WinRM-Plug-In (WinRM) ruft WSManPluginReportContext auf, um einen Shellkontext für die Shell zu registrieren. Alle Vorgänge in dieser Shell werden in diesen Kontext übergeben. Wenn die Shell heruntergefahren wurde oder das Plug-In den parameter requestDetails überprüft und meldet, dass der Vorgang abgebrochen wurde, sollte das Plug-In WSManPluginOperationComplete aufrufen. Alle übergebenen Parameter sind gültig, bis das WinRM-Plug-In WSManPluginOperationComplete aufruft.

Anforderungen