Leggere in inglese

Condividi tramite


Funzione WSManConnectShell (wsman.h)

Si connette a una sessione del server esistente.

Sintassi

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
);

Parametri

[in, out] session

Specifica l'handle di sessione restituito da una funzione WSManCreateSession . Questo parametro non può essere NULL.

flags

Riservato per utilizzi futuri. Deve essere zero.

[in] resourceUri

Definisce il tipo di shell a cui verrà effettuata la connessione. Il tipo di shell è definito da un URI univoco, pertanto l'oggetto shell restituito dalla chiamata dipende dall'URI specificato da questo parametro. Il parametro resourceUri non può essere NULL ed è una stringa con terminazione Null.

[in] shellID

Specifica l'identificatore della shell associato alla sessione della shell del server a cui il client intende connettersi.

[in, optional] options

Puntatore a una struttura WSMAN_OPTION_SET che specifica un set di opzioni per la shell. Questo parametro è facoltativo e,

[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 che contiene un contesto utente facoltativo e una funzione di callback obbligatoria. Per altre informazioni, vedere la struttura WSMAN_SHELL_ASYNC . Questo parametro non può essere NULL.

[out] shell

Specifica un handle della shell che identifica in modo univoco l'oggetto shell restituito da resourceURI. L'handle di risorse tiene traccia dell'endpoint client per la shell e viene usato da altri metodi WinRM per interagire con l'oggetto shell. L'oggetto shell deve essere eliminato chiamando il metodo WSManCloseShell . Questo parametro non può essere NULL.

Valore restituito

nessuno

Osservazioni

Si connette a una sessione della shell del server esistente identificata dal parametro ShellId . In questo modo viene compilato il contesto lato client necessario, rappresentato dalla shell dei parametri restituiti, che può essere usata per eseguire operazioni successive, ad esempio l'esecuzione di comandi e l'invio e la ricezione dell'output nella sessione della shell del server. Questa funzione WSManConnectShell non costruisce automaticamente i contesti lato client per tutti i comandi attualmente associati alla sessione della shell del server.

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
Componente ridistribuibile WinRM in Windows Server 2012.