struttura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h)

Definisce i parametri di avvio della shell da usare con la funzione WSManCreateShell . La struttura deve essere allocata dal client e passata alla funzione WSManCreateShell .

La configurazione passata alla funzione WSManCreateShell può influire direttamente sul comportamento di un comando eseguito all'interno della shell. Un esempio tipico è l'argomento workingDirectory che descrive la directory di lavoro associata a ogni processo, utilizzata dal sistema operativo durante il tentativo di individuare i file specificati usando un percorso relativo.

In assenza di requisiti specifici per la denominazione dei flussi, i client e i servizi devono tentare di usare STDIN per i flussi di input, STDOUT per il flusso di output predefinito e STDERR per il flusso di output di errore o stato.

Sintassi

typedef struct _WSMAN_SHELL_STARTUP_INFO_V10 {
  WSMAN_STREAM_ID_SET            *inputStreamSet;
  WSMAN_STREAM_ID_SET            *outputStreamSet;
  DWORD                          idleTimeoutMs;
  PCWSTR                         workingDirectory;
  WSMAN_ENVIRONMENT_VARIABLE_SET *variableSet;
} WSMAN_SHELL_STARTUP_INFO_V10;

Members

inputStreamSet

Puntatore a una struttura WSMAN_STREAM_ID_SET che specifica un set di flussi di input per la shell. I flussi non presenti nel filtro possono essere ignorati dall'implementazione della shell. Per la shell di Windows Cmd.exe, questo valore deve essere L"stdin". Se il valore è NULL, l'implementazione usa una matrice con L"stdin" come valore predefinito.

outputStreamSet

Puntatore a una struttura WSMAN_STREAM_ID_SET che specifica un set di flussi di output per la shell. I flussi non presenti nel filtro possono essere ignorati dall'implementazione della shell. Per la shell di Windows cmd.exe, questo valore deve essere L"stdout stderr". Se il valore è NULL, l'implementazione usa una matrice con L"stdout" e L"stderr" come valore predefinito.

idleTimeoutMs

Specifica la durata massima, in millisecondi, che la shell rimarrà aperta senza alcuna richiesta client. Quando viene superata la durata massima, la shell viene eliminata automaticamente. È possibile impostare qualsiasi valore compreso tra 0 e 0xFFFFFFFF. Questa durata ha un valore massimo specificato dall'impostazione Timeout di inattività dell'oggetto Criteri di gruppo, se abilitata o dalla configurazione locale IdleTimeout. Il valore predefinito della durata massima nell'oggetto Criteri di gruppo/configurazione locale è 15 minuti. Tuttavia, un amministratore di sistema può modificare questo valore. Per usare il valore massimo della configurazione dell'oggetto Criteri di gruppo/locale, il client deve specificare 0 (zero) in questo campo. Se viene usato un valore esplicito compreso tra 0 e 0xFFFFFFFF, viene usato il valore minimo tra il valore API esplicito e il valore della configurazione dell'oggetto Criteri di gruppo/locale.

workingDirectory

Specifica la directory iniziale per una shell. Viene usato con qualsiasi comando di esecuzione. Se questo membro è un valore NULL , una directory predefinita verrà usata dal computer remoto durante l'esecuzione del comando. Un valore vuoto viene considerato dal protocollo sottostante come valore omesso.

variableSet

Puntatore a una struttura WSMAN_ENVIRONMENT_VARIABLE_SET che specifica una matrice di coppie nome e valore di variabile, che descrivono l'ambiente iniziale per la shell. Il contenuto di questi elementi è specifico della shell e può essere definito in termini di altre variabili di ambiente. Se viene passato un valore NULL , l'ambiente predefinito viene usato sul lato server.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Intestazione	wsman.h
Componente ridistribuibile	Windows Management Framework in Windows Server 2008 con SP2, Windows Vista con SP1 e Windows Vista con SP2