WSMAN_PLUGIN_RECEIVE funzione di callback (wsman.h)

Articolo
08/28/2023

Definisce il callback di ricezione per un plug-in. Questa funzione viene chiamata quando viene ricevuta una richiesta in ingresso per ricevere i dati.

Il nome del punto di ingresso della DLL deve essere WSManPluginReceive.

Sintassi

WSMAN_PLUGIN_RECEIVE WsmanPluginReceive;

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

Parametri

requestDetails

Puntatore a una struttura WSMAN_PLUGIN_REQUEST che specifica l'URI, le opzioni, le impostazioni locali, il flag di arresto e l'handle per la richiesta.

flags

Riservato per utilizzi futuri. Deve essere zero.

shellContext

Specifica il contesto ricevuto quando è stata creata la shell.

commandContext

Se questa richiesta è destinata a un comando e non a una shell, questo è il contesto restituito dall'operazione di creazione winrm ; in caso contrario, questo parametro è NULL.

streamSet

Struttura WSMAN_STREAM_ID_SET che contiene un elenco di flussi per i quali i dati devono essere ricevuti. Se questo elenco è vuoto, tutti i flussi configurati nella shell sono impliciti, il che significa che tutti i flussi sono disponibili.

Valore restituito

nessuno

Osservazioni

In base alla richiesta client, è possibile chiamare la funzione di callback WSMAN_PLUGIN_RECEIVE sulla shell e/o sul comando. Il plug-in chiama il metodo WSManPluginReceiveResult per ogni pezzo di dati che deve essere inviato al client. Dopo l'invio di tutti i dati, il plug-in chiama WSManPluginOperationComplete per terminare il flusso. Tutti i parametri passati sono validi finché il plug-in Gestione remota Windows (WinRM) chiama WSManPluginOperationComplete.

Requisiti


Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2

Condividi tramite