estrutura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h)

Define os parâmetros de inicialização do shell a serem usados com a função WSManCreateShell . A estrutura deve ser alocada pelo cliente e passada para a função WSManCreateShell .

A configuração passada para a função WSManCreateShell pode afetar diretamente o comportamento de um comando executado dentro do shell. Um exemplo típico é o argumento workingDirectory que descreve o diretório de trabalho associado a cada processo, que o sistema operacional usa ao tentar localizar arquivos especificados usando um caminho relativo.

Na ausência de requisitos específicos para nomenclatura de fluxo, clientes e serviços devem tentar usar STDIN para fluxos de entrada, STDOUT para o fluxo de saída padrão e STDERR para o fluxo de saída de erro ou status.

Sintaxe

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;

Membros

inputStreamSet

Um ponteiro para uma estrutura WSMAN_STREAM_ID_SET que especifica um conjunto de fluxos de entrada para o shell. Os fluxos não presentes no filtro podem ser ignorados pela implementação do shell. Para o shell Cmd.exe do Windows, esse valor deve ser L"stdin". Se o valor for NULL, a implementação usará uma matriz com L"stdin" como o valor padrão.

outputStreamSet

Um ponteiro para uma estrutura WSMAN_STREAM_ID_SET que especifica um conjunto de fluxos de saída para o shell. Os fluxos não presentes no filtro podem ser ignorados pela implementação do shell. Para o shell cmd.exe do Windows, esse valor deve ser L"stdout stderr". Se o valor for NULL, a implementação usará uma matriz com L"stdout" e L"stderr" como o valor padrão.

idleTimeoutMs

Especifica a duração máxima, em milissegundos, que o shell permanecerá aberto sem nenhuma solicitação de cliente. Quando a duração máxima é excedida, o shell é excluído automaticamente. Qualquer valor de 0 a 0xFFFFFFFF pode ser definido. Essa duração tem um valor máximo especificado pela configuração gpo de tempo limite ocioso, se habilitada, ou pela configuração local IdleTimeout. O valor padrão da duração máxima na configuração gpo/local é de 15 minutos. No entanto, um administrador do sistema pode alterar esse valor. Para usar o valor máximo da configuração GPO/local, o cliente deve especificar 0 (zero) nesse campo. Se um valor explícito entre 0 e 0xFFFFFFFF for usado, o valor mínimo entre o valor explícito da API e o valor da configuração GPO/local será usado.

workingDirectory

Especifica o diretório inicial de um shell. Ele é usado com qualquer comando de execução. Se esse membro for um valor NULL , um diretório padrão será usado pelo computador remoto ao executar o comando. Um valor vazio é tratado pelo protocolo subjacente como um valor omitido.

variableSet

Um ponteiro para uma estrutura WSMAN_ENVIRONMENT_VARIABLE_SET que especifica uma matriz de pares de nome e valor de variável, que descrevem o ambiente inicial do shell. O conteúdo desses elementos é específico do shell e pode ser definido em termos de outras variáveis de ambiente. Se um valor NULL for passado, o ambiente padrão será usado no lado do servidor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7
Servidor mínimo com suporte	Windows Server 2008 R2
Cabeçalho	wsman.h
Redistribuível	Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2