função MI_Application_NewSession (mi.h)
Cria uma sessão usada para compartilhar conexões para um conjunto de operações para um único destino.
Sintaxe
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
Um ponteiro para um identificador retornado da função MI_Application_Initialize .
[in, optional] protocol
Um ponteiro para um manipulador de protocolo opcional para executar a operação. Se esse parâmetro for NULL, um valor padrão será usado, com base no destino. Atualmente, os protocolos com suporte são L"WMIDCOM" e L"WINRM".
[in, optional] destination
Um destino opcional para a sessão. Se o argumento de destino for NULL, a sessão se comunicará com o computador local. Caso contrário, o destino pode ser o nome do computador do computador local ou de um computador remoto.
[in, optional] options
Um ponteiro para opções de destino opcionais, como tempos limite e credenciais padrão.
[in, optional] callbacks
Um ponteiro para uma estrutura de MI_SessionCallbacks opcional que contém retornos de chamada para receber vários resultados.
extendedError
Ponteiro para informações de erro adicionais opcionais se a operação falhou. Quando terminar de usar as informações de erro, libere a memória chamando a função MI_Instance_Delete .
[out] session
Um ponteiro para o identificador de sessão retornado. Quando terminar de usar o identificador de sessão, feche-o chamando a função MI_Session_Close . Se o identificador de sessão não estiver fechado antes de desligar o aplicativo e o identificador do aplicativo, o desligamento do identificador do aplicativo não responderá.
Retornar valor
Essa função retorna MI_INLINE MI_Result.
Comentários
A criação de um destino pode não se comunicar com o computador de destino. Não será até que a primeira operação seja executada em uma sessão que o aplicativo possa determinar se o computador está acessível.
A função MI_Session_Close deve ser chamada no identificador de sessão de saída. Feche todas as operações na sessão de destino antes de fechar a sessão.
Se nenhum protocolo for especificado e o destino for NULL, o protocolo WMIDCOM será usado. Se nenhum protocolo for especificado e o destino não for NULL, o protocolo WINRM será usado. .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Windows |
| Cabeçalho | mi.h |
| Redistribuível | Windows Management Framework 3.0 no Windows Server 2008 R2 com SP1, Windows 7 com SP1 e Windows Server 2008 com SP2 |