WSMAN_PLUGIN_RECEIVE Rückruffunktion (wsman.h)

Artikel
08/28/2023

Definiert den Empfangsrückruf für ein Plug-In. Diese Funktion wird aufgerufen, wenn eine eingehende Anforderung zum Empfangen von Daten empfangen wird.

Der Name des DLL-Einstiegspunkts muss WSManPluginReceive sein.

Syntax

WSMAN_PLUGIN_RECEIVE WsmanPluginReceive;

void WsmanPluginReceive(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PVOID commandContext,
  WSMAN_STREAM_ID_SET *streamSet
)
{...}

Parameter

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 Null sein.

shellContext

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

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.

streamSet

Eine WSMAN_STREAM_ID_SET-Struktur , die eine Liste von Datenströmen enthält, für die Daten empfangen werden sollen. Wenn diese Liste leer ist, werden alle Streams, die in der Shell konfiguriert wurden, impliziert, was bedeutet, dass alle Streams verfügbar sind.

Rückgabewert

Keine

Bemerkungen

Basierend auf der Clientanforderung kann die WSMAN_PLUGIN_RECEIVE Rückruffunktion für die Shell und/oder den Befehl aufgerufen werden. Das Plug-In ruft die WSManPluginReceiveResult-Methode für jedes Datenstück auf, das an den Client zurückgesendet werden muss. Nachdem alle Daten gesendet wurden, ruft das Plug-In WSManPluginOperationComplete auf, um den Stream zu beenden. Alle übergebenen Parameter sind gültig, bis das WinRM-Plug-In (Windows Remote Management) WSManPluginOperationComplete aufruft.

Anforderungen


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

Freigeben über