Función WSManConnectShell (wsman.h)

Se conecta a una sesión de servidor existente.

Sintaxis

void WSManConnectShell(
  [in, out]      WSMAN_SESSION_HANDLE session,
                 DWORD                flags,
  [in]           PCWSTR               resourceUri,
  [in]           PCWSTR               shellID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_SHELL_HANDLE   *shell
);

Parámetros

[in, out] session

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

flags

Reservado para uso futuro. Debe ser cero.

[in] resourceUri

Define el tipo de shell al que se realizará la conexión. El tipo de shell se define mediante un URI único, por lo que el objeto de shell devuelto por la llamada depende del URI especificado por este parámetro. El parámetro resourceUri no puede ser NULL y es una cadena terminada en NULL.

[in] shellID

Especifica el identificador de shell asociado a la sesión del shell de servidor a la que el cliente pretende conectarse.

[in, optional] options

Puntero a una estructura WSMAN_OPTION_SET que especifica un conjunto de opciones para el shell. Este parámetro es opcional.

[in, optional] connectXml

Puntero a una estructura WSMAN_DATA que define un contexto abierto para la operación de shell de conexión. El contenido debe ser una cadena XML válida. Este parámetro puede ser NULL.

[in] async

Define una estructura asincrónica que contiene un contexto de usuario opcional y una función de devolución de llamada obligatoria. Consulte la estructura WSMAN_SHELL_ASYNC para obtener más información. Este parámetro no puede ser NULL.

[out] shell

Especifica un identificador de shell que identifica de forma única el objeto de shell devuelto por resourceURI. El identificador de recursos realiza un seguimiento del punto de conexión de cliente para el shell y lo usan otros métodos winRM para interactuar con el objeto de shell. El objeto de shell debe eliminarse llamando al método WSManCloseShell . Este parámetro no puede ser NULL.

Valor devuelto

None

Observaciones

Se conecta a una sesión de shell de servidor existente identificada por el parámetro ShellId . Esto compila el contexto del lado cliente necesario, representado por el shell de parámetros de devolución, que se puede usar para llevar a cabo operaciones posteriores, como ejecutar comandos y enviar y recibir la salida en la sesión del shell del servidor. Esta función WSManConnectShell no construye automáticamente los contextos del lado cliente para los comandos que están asociados actualmente a la sesión del shell de servidor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	wsman.h
Library	WsmSvc.lib
Archivo DLL	WsmSvc.dll
Redistribuible	WinRM en Windows Server 2012.