Funzione WSManCreateShell (wsman.h)

Crea un oggetto shell. L'handle della shell restituito identifica un oggetto che definisce il contesto in cui è possibile eseguire i comandi. Il contesto è definito dalle variabili di ambiente, dai flussi di input e di output e dalla directory di lavoro. Il contesto può influire direttamente sul comportamento di un comando. Un contesto della shell viene creato nel computer remoto specificato dal parametro di connessione e autenticato usando il parametro credenziali.

Sintassi

void WSManCreateShell(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

Parametri

[in, out] session

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

flags

Riservato per utilizzi futuri. Deve essere zero.

[in] resourceUri

Definisce il tipo di shell da creare. Il tipo di shell è definito da un URI univoco. L'oggetto shell effettivo restituito dalla chiamata dipende dall'URI specificato. Questo parametro non può essere NULL. Per creare una shell di windows cmd.exe, usare l'URI della risorsa WSMAN_CMDSHELL_URI .

[in, optional] startupInfo

Puntatore a una struttura WSMAN_SHELL_STARTUP_INFO che specifica i flussi di input e di output, la directory di lavoro, il timeout inattiva e le opzioni per la shell.

Se questo parametro è NULL, verranno usati i valori predefiniti.

[in, optional] options

Puntatore a una struttura WSMAN_OPTION_SET che specifica un set di opzioni per la shell.

[in, optional] createXml

Puntatore a una struttura WSMAN_DATA che definisce un contesto aperto per la shell. Il contenuto deve essere una stringa XML valida. Questo parametro può essere NULL.

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

[out] shell

Definisce un handle della shell che identifica in modo univoco l'oggetto shell. L'handle di risorse viene usato per tenere traccia dell'endpoint client per la shell e viene usato da altri metodi WinRM per interagire con l'oggetto shell. L'oggetto shell deve essere eliminato chiamando il metodo WSManCloseShell . 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