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

Статья
11/20/2024

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

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

Синтаксис

HANDLE OpenNtmsSessionW(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntmsapi.h
библиотеки	Ntmsapi.lib
DLL	Ntmsapi.dll

См. также

CloseNtmsSession

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

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