WSMAN_PLUGIN_SIGNAL funzione di callback (wsman.h)
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 |