Funzione WSManSignalShell (wsman.h)

Articolo
03/13/2024

Invia un codice di controllo a un comando esistente o alla shell stessa.

Sintassi

void WSManSignalShell(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 code,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *signalOperation
);

Parametri

[in] shell

Specifica l'handle restituito da una chiamata WSManCreateShell . Questo parametro non può essere NULL.

[in, optional] command

Specifica l'handle di comando restituito da una chiamata WSManRunShellCommand . Se questo valore è NULL, il codice del segnale viene inviato alla shell.

flags

Riservato per utilizzi futuri. Deve essere impostato su zero.

[in] code

Specifica il codice del segnale da inviare al comando o alla shell. I codici seguenti sono comuni.

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

La shell o la finestra del prompt dei comandi è stata chiusa.

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

È stato ricevuto il segnale per CTRL+C e il processo è stato interrotto.

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Il segnale per CTRL+INTERR è stato ricevuto e il processo è stato interrotto.

[in] async

Definisce una struttura asincrona. La struttura asincrona contiene un contesto utente facoltativo e una funzione di callback obbligatoria. Per altre informazioni, vedere la struttura WSMAN_SHELL_ASYNC . Questo parametro non può essere NULL e deve essere chiuso chiamando il metodo WSManCloseOperation .

[out] signalOperation

Definisce l'handle dell'operazione per l'operazione di segnale. Questo handle viene restituito da una chiamata corretta della funzione e può essere usato per annullare in modo asincrono l'operazione del segnale. Questo handle deve essere chiuso chiamando il metodo WSManCloseOperation . Questo parametro non può essere NULL.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Libreria	WsmSvc.lib
DLL	WsmSvc.dll
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2

Condividi tramite