Поделиться через

Функция OpenNtmsSessionA (ntmsapi.h)

  • Статья

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Функция OpenNtmsSession настраивает сеанс с сервером RSM.

Синтаксис

HANDLE OpenNtmsSessionA(
  [in] LPCSTR lpServer,
  [in] LPCSTR lpApplication,
       DWORD  dwOptions
);

Параметры

[in] lpServer

Имя сервера RSM. Если этот параметр имеет значение NULL, используется текущее имя компьютера.

[in] lpApplication

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

dwOptions

Защищены; значение должно быть равно нулю.

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

Если OpenNtmsSession завершается успешно, он возвращает дескриптор, который однозначно идентифицирует этот сеанс. Если функция завершается сбоем, она возвращает INVALID_HANDLE_VALUE. Чтобы получить дополнительные сведения, вызовите функцию GetLastError . Эта функция может возвращать одно из следующих значений.

Значение Значение
ERROR_INVALID_COMPUTERNAME
 Указанный формат имени компьютера не имеет допустимого формата.
ERROR_INVALID_PARAMETER
 Одно из значений параметра было недопустимым.
ERROR_NO_NETWORK
 Сеть не запущена или недоступна.
ERROR_NOT_CONNECTED
 Не удается подключиться к службе RSM.
ERROR_NOT_READY
 Служба RSM не запущена. Приложение должно дождаться и повторить попытку.
ERROR_SUCCESS
 Функция выполнена успешно.
INVALID_HANDLE_VALUE
 RSM не может открыть сеанс.
RPC_S_NO_INTERFACES
 Служба использует более раннюю версию RSM, чем ваше приложение.

Комментарии

Функция OpenNtmsSession возвращает дескриптор сеанса, используемый с другими функциями RSM, устанавливает соединение с базой данных RSM и инициализирует подсистему RSM для приложения.

Когда OpenNtmsSession возвращается, приложение может выполнять операции RSM.

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

Примечание

Заголовок ntmsapi.h определяет OpenNtmsSession в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntmsapi.h
Библиотека Ntmsapi.lib
DLL Ntmsapi.dll

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

CloseNtmsSession

Функции управления сеансами