Funzione WSManConnectShellCommand (wsman.h)

Si connette a un comando esistente in esecuzione in una shell.

Sintassi

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_COMMAND_HANDLE *command
);

Parametri

[in, out] shell

Specifica l'handle della shell restituito dalla chiamata WSManCreateShell . Questo parametro non può essere NULL.

flags

Riservato per utilizzi futuri. Deve essere zero.

[in] commandID

Stringa con terminazione null che identifica un comando specifico, attualmente in esecuzione nella sessione del server, a cui il client intende connettersi.

[in, optional] options

Definisce un set di opzioni per il comando. Queste opzioni vengono passate al servizio per modificare o perfezionare l'esecuzione del comando. Questo parametro può essere NULL. Per altre informazioni sulle opzioni, vedere WSMAN_OPTION_SET.

[in, optional] connectXml

Puntatore a una struttura WSMAN_DATA che definisce un contesto aperto per l'operazione della shell di connessione. Il contenuto deve essere una stringa XML valida. Questo parametro può essere NULL.

[in] async

Definisce una struttura asincrona per contenere un contesto utente facoltativo e una funzione di callback obbligatoria. Per altre informazioni, vedere WSMAN_SHELL_ASYNC. Questo parametro non può essere NULL.

[out] command

Questo handle viene restituito in una chiamata riuscita e viene usato per inviare e ricevere dati e per segnalare il comando. Al termine dell'uso di questo handle, chiuderlo chiamando il metodo WSManCloseCommand . Questo parametro non può essere NULL.

Valore restituito

nessuno

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	wsman.h
Libreria	WsmSvc.lib
DLL	WsmSvc.dll