WSMAN_PLUGIN_SHELL Rückruffunktion (wsman.h)

Artikel
03/04/2024

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

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