Funzione WSManConnectShell (wsman.h)
Si connette a una sessione del server esistente.
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
);
[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.
nessuno
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.
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. |