Compartilhar via

Função WSManSetSessionOption (wsman.h)

  • Artigo

Define um conjunto estendido de opções para a sessão.

Sintaxe

DWORD WSManSetSessionOption(
  [in] WSMAN_SESSION_HANDLE session,
       WSManSessionOption   option,
  [in] WSMAN_DATA           *data
);

Parâmetros

[in] session

Especifica o identificador de sessão retornado por uma chamada WSManCreateSession . Esse parâmetro não pode ser NULL.

option

Especifica a opção a ser definida. Esse parâmetro deve ser definido como um dos valores na enumeração WSManSessionOption .

[in] data

Um ponteiro para uma estrutura WSMAN_DATA que define o valor da opção.

Retornar valor

Esse método retorna zero em caso de êxito. Caso contrário, esse método retornará um código de erro.

Comentários

Se o método WSManSetSessionOption for chamado com valores diferentes especificados para o parâmetro de opção , a ordem das diferentes opções será importante. Na primeira vez que WSManSetSessionOption for chamado, o transporte será definido para a sessão. Se uma segunda chamada solicitar um tipo diferente de transporte, a chamada falhará.

Por exemplo, a segunda chamada de método falhará se os métodos forem chamados na seguinte ordem:

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
A primeira chamada de método define o transporte como HTTP porque o parâmetro de opção é definido como WSMAN_OPTION_UNENCRYPTED_MESSAGES. A segunda chamada falha porque a opção que foi passada é aplicável a HTTPS e o transporte foi definido como HTTP pela primeira mensagem.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho wsman.h
Biblioteca WsmSvc.lib
DLL WsmSvc.dll
Redistribuível Windows Management Framework no Windows Server 2008 com SP2, Windows Vista com SP1 e Windows Vista com SP2