funzione MI_Context_GetLocalSession (mi.h)

Ottiene la sessione locale (MI_Session) che consente al provider di eseguire operazioni CIM sul server locale che ospita il provider.

Sintassi

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_GetLocalSession(
  [in]  const MI_Context *context,
  [out] MI_Session       *session
);

Parametri

[in] context

Puntatore al contesto della richiesta.

[out] session

Puntatore all'oggetto MI_Session restituito. Questa sessione non deve essere chiusa.

Valore restituito

Valore dell'enumerazione MI_Result che specifica il codice restituito dalla funzione. Può trattarsi di uno dei codici seguenti.

Commenti

Questa sessione viene pre-creata e ha la durata del contesto da cui è stata ottenuta la sessione. Il provider non deve chiudere questa sessione perché la durata è associata al contesto.

Il provider deve chiamare questa funzione anziché creare una nuova sessione tramite la funzione MI_Application_NewSession , perché alcune ottimizzazioni potrebbero essere possibili per comunicare con il server CIM.

Il contesto di sicurezza usato per chiamare la funzione MI_Context_GetLocalSession deve essere la stessa identità usata per comunicare al server tramite le funzioni operative MI_Session_*. Non memorizzare nella cache queste sessioni all'esterno dell'operazione corrente. Il provider chiama questo metodo più volte all'interno di un'operazione con identità diverse, nel qual caso la sessione recuperata deve essere usata anche con la stessa identità. Qualsiasi operazione nella sessione deve essere sempre la stessa identità recuperata dall'utente per la sessione locale. In caso contrario, l'operazione potrebbe non riuscire con il codice restituito MI_RESULT_ACCESS_DENIED .

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