Funzione WSManRunShellCommand (wsman.h)

Avvia l'esecuzione di un comando all'interno di una shell esistente e non attende il completamento del comando.

Sintassi

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

Parametri

[in, out] shell

Specifica l'handle della shell restituito dalla chiamata WSManCreateShell . Questo parametro non può essere NULL.

flags

Riservato per utilizzi futuri. Deve essere zero.

[in] commandLine

Definisce una stringa con terminazione Null obbligatoria che rappresenta il comando da eseguire. In genere, il comando viene specificato senza argomenti, specificati separatamente. Tuttavia, un utente può specificare la riga di comando e tutti gli argomenti usando questo parametro. Se per il parametro commandLine vengono specificati argomenti, il parametro args deve essere NULL.

[in, optional] args

Puntatore a una struttura WSMAN_COMMAND_ARG_SET che definisce una matrice di valori di argomento, che vengono passati al comando al momento della creazione. Se non sono necessari argomenti, questo parametro deve essere NULL.

[in, optional] options

Definisce un set di opzioni per il comando. Queste opzioni vengono passate al servizio per modificare o perfezionare l'esecuzione del comando. Questo parametro può essere NULL. Per altre informazioni sulle opzioni, vedere WSMAN_OPTION_SET.

[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 WSManCloseCommand .

[out] command

Definisce l'oggetto comando associato a un comando all'interno di una shell. Questo handle viene restituito in una chiamata riuscita e viene usato per inviare e ricevere dati e per segnalare il comando. Questo handle deve essere chiuso chiamando il metodo WSManCloseCommand . Questo parametro non può essere NULL.

Valore restituito

nessuno

Requisiti

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