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

  • Статья

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

Функция SetNtmsDeviceChangeDetection задает одно или несколько целевых устройств для обнаружения изменений.

Синтаксис

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Параметры

[in] hSession

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

[in] DetectHandle

Дескриптор обнаружения изменений устройства из BeginNtmsDeviceChangeDetection или NULL для одного опроса.

[in] lpRequestId

Идентификатор объекта для целевого устройства. Этот параметр может быть одним или несколькими библиотеками, типами мультимедиа или физическими ИДЕНТИФИКАТОРами мультимедиа. Все идентификаторы GUID должны иметь одинаковый тип.

[in] dwType

Тип идентификаторов объектов, указанных в параметре lpObjectId . Этот параметр может иметь одно из следующих значений из типа перечисления NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE или NTMS_PHYSICAL_MEDIA.

[in] dwCount

Число идентификаторов объектов в lpObjectId.

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

Эта функция возвращает одно из следующих значений.

Значение Значение
ERROR_INVALID_HANDLE
 Недопустимый сеанс или дескриптор обнаружения.
ERROR_INVALID_PARAMETER
 Недопустимый тип объекта.
ERROR_INVALID_LIBRARY
 Указанная библиотека не найдена.
ERROR_INVALID_MEDIA
 Указанный носитель или тип не найден.
ERROR_SUCCESS
 Запрос оператора отменен.

Комментарии

Устройство можно указать напрямую путем передачи идентификаторов GUID библиотеки или косвенно путем передачи физических носителей или идентификаторов GUID типа мультимедиа. При использовании непрямой спецификации обнаруживаются все автономные библиотеки, которые могут содержать носитель или тип носителя. Все указанные устройства будут обнаруживаться до тех пор, пока не будет закрыт дескриптор обнаружения изменений устройства с помощью функции EndNtmsDeviceChangeDetection .

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

Требования

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

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

BeginNtmsDeviceChangeDetection

Функции обнаружения изменений

EndNtmsDeviceChangeDetection