Compartir a través de

Función WSManSetSessionOption (wsman.h)

  • Artículo

Establece un conjunto extendido de opciones para la sesión.

Sintaxis

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

Parámetros

[in] session

Especifica el identificador de sesión devuelto por una llamada WSManCreateSession . Este parámetro no puede ser NULL.

option

Especifica la opción que se va a establecer. Este parámetro debe establecerse en uno de los valores de la enumeración WSManSessionOption .

[in] data

Puntero a una estructura WSMAN_DATA que define el valor de opción.

Valor devuelto

Este método devuelve cero si se ejecuta correctamente. De lo contrario, este método devuelve un código de error.

Comentarios

Si se llama al método WSManSetSessionOption con valores diferentes especificados para el parámetro de opción , el orden de las distintas opciones es importante. La primera vez que se llama a WSManSetSessionOption , el transporte se establece para la sesión. Si una segunda llamada solicita un tipo de transporte diferente, se producirá un error en la llamada.

Por ejemplo, se producirá un error en la segunda llamada al método si se llama a los métodos en el orden siguiente:

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
La primera llamada al método establece el transporte en HTTP porque el parámetro option se establece en WSMAN_OPTION_UNENCRYPTED_MESSAGES. Se produce un error en la segunda llamada porque la opción que se pasó es aplicable a HTTPS y el transporte se estableció en HTTP por el primer mensaje.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado wsman.h
Library WsmSvc.lib
Archivo DLL WsmSvc.dll
Redistribuible Windows Management Framework en Windows Server 2008 con SP2, Windows Vista con SP1 y Windows Vista con SP2