WSMAN_PLUGIN_SIGNAL funzione di callback (wsman.h)

Articolo
08/28/2023

Definisce il callback del segnale per un plug-in. Questa funzione viene chiamata quando viene ricevuto un segnale in ingresso da una chiamata client.

Il nome del punto di ingresso della DLL per questo metodo deve essere WSManPluginSignal.

Sintassi

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

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

Parametri

[in] requestDetails

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

[in] flags

Riservato per utilizzi futuri. Deve essere zero.

[in] shellContext

Specifica il contesto ricevuto al momento della creazione della shell.

[in, optional] 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.

[in] code

Specifica il segnale ricevuto dal client. I codici seguenti sono comuni.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

La shell o la finestra del prompt dei comandi è stata chiusa. Il plug-in deve chiamare la funzione WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

È stato ricevuto il segnale per CTRL+C e il processo è stato interrotto. Il plug-in deve chiamare la funzione WSManPluginOperationComplete .

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Il segnale per CTRL+INTERR è stato ricevuto e il processo è stato interrotto. Il plug-in deve chiamare la funzione WSManPluginOperationComplete .

Valore restituito

nessuno

Osservazioni

È possibile ricevere un segnale per l'elaborazione di una sequenza CTRL+C o di molti altri tipi di segnali personalizzati. Il callback viene chiamato una volta per ogni segnale ricevuto. Il plug-in determina quali segnali causano l'arresto di comandi e/o shell. Poiché i segnali sono specifici della shell, il plug-in deve avviare l'arresto chiamando il metodo WSManPluginOperationComplete . Per ogni chiamata, il plug-in deve chiamare WSManPluginOperationComplete per confermare la ricezione e consentire la ricezione del segnale successivo.

Requisiti

Requisito	Valore
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 e Windows Vista con SP2

Condividi tramite