funzione MI_Application_NewSession (mi.h)
Crea una sessione utilizzata per condividere le connessioni per un set di operazioni a una singola destinazione.
Sintassi
MI_INLINE MI_Result MI_Application_NewSession(
[in] MI_Application *application,
[in, optional] const MI_Char *protocol,
[in, optional] const MI_Char *destination,
[in, optional] MI_DestinationOptions *options,
[in, optional] MI_SessionCallbacks *callbacks,
MI_Instance **extendedError,
[out] MI_Session *session
);
Parametri
[in] application
Puntatore a un handle restituito dalla funzione MI_Application_Initialize .
[in, optional] protocol
Puntatore a un gestore di protocollo facoltativo per eseguire l'operazione. Se questo parametro è NULL, viene usato un valore predefinito, in base alla destinazione. I protocolli attualmente supportati sono L"WMIDCOM" e L"WINRM".
[in, optional] destination
Destinazione facoltativa per la sessione. Se l'argomento di destinazione è NULL, la sessione comunica con il computer locale. In caso contrario, la destinazione può essere il nome computer del computer locale o un computer remoto.
[in, optional] options
Puntatore alle opzioni di destinazione facoltative, ad esempio timeout predefiniti e credenziali.
[in, optional] callbacks
Puntatore a una struttura di MI_SessionCallbacks facoltativa che contiene callback per ricevere vari risultati.
extendedError
Puntatore a informazioni aggiuntive facoltative sull'errore se l'operazione non è riuscita. Al termine dell'utilizzo delle informazioni sull'errore, liberare la memoria chiamando la funzione MI_Instance_Delete .
[out] session
Puntatore all'handle di sessione restituito. Al termine dell'uso dell'handle di sessione, chiuderlo chiamando la funzione MI_Session_Close . Se l'handle di sessione non viene chiuso prima di arrestare sia l'applicazione che l'handle dell'applicazione, l'handle dell'applicazione non risponderà.
Valore restituito
Questa funzione restituisce MI_INLINE MI_Result.
Commenti
La creazione di una destinazione potrebbe non comunicare con il computer di destinazione. Non sarà fino a quando non viene eseguita la prima operazione in una sessione che l'applicazione può determinare se il computer è accessibile.
La funzione MI_Session_Close deve essere chiamata nell'handle di sessione in uscita. Chiudere tutte le operazioni nella sessione di destinazione prima di chiudere la sessione.
Se non viene specificato alcun protocollo e la destinazione è NULL, viene usato il protocollo WMIDCOM. Se non viene specificato alcun protocollo e la destinazione non è NULL, viene usato il protocollo WINRM. .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Server minimo supportato | Windows Server 2012 |
| Piattaforma di destinazione | Windows |
| Intestazione | mi.h |
| Componente ridistribuibile | Windows Management Framework 3.0 in Windows Server 2008 R2 con SP1, Windows 7 con SP1 e Windows Server 2008 con SP2 |