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

  • Статья

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

Функция OpenNtmsNotification открывает канал для получения уведомлений об изменении объектов RSM для объектов указанного типа.

Синтаксис

HANDLE OpenNtmsNotification(
  [in] HANDLE hSession,
  [in] DWORD  dwType
);

Параметры

[in] hSession

Дескриптор сеанса, возвращаемого функцией OpenNtmsSession .

[in] dwType

Тип объекта RSM для уведомления. Список значений см. в разделе NtmsObjectsTypes.

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

Функция OpenNtmsNotification возвращает дескриптор уведомления, который передается функциям WaitForNtmsNotification или CloseNtmsNotification .

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

Значение Значение
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS на компьютер запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.

Windows XP: Права доступа не требуются.
ERROR_DATABASE_FAILURE
 Сбой запроса или обновления базы данных.
ERROR_INVALID_HANDLE
 Значение, указанное в параметре hSession , равно NULL или недопустимо.
ERROR_NOT_CONNECTED
 Не удается подключиться к службе RSM.
ERROR_SUCCESS
 Функция выполнена успешно.
INVALID_HANDLE_VALUE
 Сбой функции.

Требования

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

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

CloseNtmsNotification

Функции уведомлений базы данных

WaitForNtmsNotification