función MI_Application_NewSession (mi.h)
Crea una sesión que se usa para compartir conexiones para un conjunto de operaciones en un único destino.
Sintaxis
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
);
Parámetros
[in] application
Puntero a un identificador devuelto desde la función MI_Application_Initialize .
[in, optional] protocol
Puntero a un controlador de protocolo opcional para llevar a cabo la operación. Si este parámetro es NULL, se usa un valor predeterminado, en función del destino. Actualmente, los protocolos admitidos son L"WMIDCOM" y L"WINRM".
[in, optional] destination
Un destino opcional para la sesión. Si el argumento de destino es NULL, la sesión se comunica con el equipo local. De lo contrario, el destino puede ser el nombre del equipo local o un equipo remoto.
[in, optional] options
Puntero a opciones de destino opcionales, como los tiempos de espera predeterminados y las credenciales.
[in, optional] callbacks
Puntero a una estructura de MI_SessionCallbacks opcional que contiene devoluciones de llamada para recibir varios resultados.
extendedError
Puntero a información de error adicional opcional si se produjo un error en la operación. Cuando haya terminado de usar la información de error, libere la memoria llamando a la función MI_Instance_Delete .
[out] session
Puntero al identificador de sesión devuelto. Cuando haya terminado de usar el identificador de sesión, ciérrelo llamando a la función MI_Session_Close . Si el identificador de sesión no se cierra antes de apagar la aplicación y el identificador de la aplicación, el identificador de la aplicación no responderá.
Valor devuelto
Esta función devuelve MI_INLINE MI_Result.
Comentarios
Es posible que la creación de un destino no se comunique con el equipo de destino. No será hasta que se lleve a cabo la primera operación en una sesión que la aplicación pueda determinar si el equipo es accesible.
Se debe llamar a la función MI_Session_Close en el identificador de sesión de salida. Cierre todas las operaciones en la sesión de destino antes de cerrar la sesión.
Si no se especifica ningún protocolo y el destino es NULL, se usa el protocolo WMIDCOM. Si no se especifica ningún protocolo y el destino no es NULL, se usa el protocolo WINRM. .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Windows |
| Encabezado | mi.h |
| Redistribuible | Windows Management Framework 3.0 en Windows Server 2008 R2 con SP1, Windows 7 con SP1 y Windows Server 2008 con SP2 |