функция MI_Application_NewSession (mi.h)

Создает сеанс, используемый для совместного использования подключений для набора операций к одному назначению.

Синтаксис

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
);

Параметры

[in] application

Указатель на дескриптор, возвращаемый функцией MI_Application_Initialize .

[in, optional] protocol

Указатель на необязательный обработчик протокола для выполнения операции. Если этот параметр имеет значение NULL, используется значение по умолчанию в зависимости от назначения. В настоящее время поддерживаются протоколы L"WMIDCOM" и L"WINRM".

[in, optional] destination

Необязательное назначение для сеанса. Если аргумент назначения имеет значение NULL, сеанс взаимодействует с локальным компьютером. В противном случае назначением может быть имя локального компьютера или удаленного компьютера.

[in, optional] options

Указатель на необязательные параметры назначения, такие как время ожидания по умолчанию и учетные данные.

[in, optional] callbacks

Указатель на необязательную структуру MI_SessionCallbacks, содержащую обратные вызовы для получения различных результатов.

extendedError

Указатель на необязательные дополнительные сведения об ошибке, если операция завершилась сбоем. Завершив использование сведений об ошибке, освободите память, вызвав функцию MI_Instance_Delete .

[out] session

Указатель на возвращенный дескриптор сеанса. Завершив использование дескриптора сеанса, закройте его, вызвав функцию MI_Session_Close . Если дескриптор сеанса не закрыт до завершения работы приложения и дескриптора приложения, завершение работы дескриптора приложения не будет отвечать.

Возвращаемое значение

Эта функция возвращает MI_INLINE MI_Result.

Комментарии

Создание назначения может не взаимодействовать с конечным компьютером. Приложение не сможет определить, доступен ли компьютер, пока первая операция не будет выполнена в сеансе.

Функция MI_Session_Close должна вызываться для дескриптора исходящего сеанса. Перед закрытием сеанса закройте все операции в целевом сеансе.

Если протокол не указан и назначение имеет значение NULL, используется протокол WMIDCOM. Если протокол не указан, а назначение не равно NULL, используется протокол WINRM. .

Требования

См. также раздел

Удаленное управление Windows