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

Статья
08/25/2023

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

Функция CancelNtmsLibraryRequest отменяет невыполненные запросы RSM, такие как вызовы функции CleanNtmsDrive . Если библиотека занята, RSM помещает отмену в очередь и возвращает успешное выполнение.

Синтаксис

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Параметры

[in] hSession

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

[in] lpRequestId

Уникальный идентификатор отмененного запроса библиотеки.

Чтобы получить список существующих запросов библиотеки, используйте функцию EnumerateNtmsObject .

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Только администратор сервера RSM может отменять запросы библиотеки. Эта ошибка также возвращается, если запрос обрабатывается и не может быть удален.
ERROR_INVALID_HANDLE	Дескриптор сеанса отсутствует или недопустим.
ERROR_NOT_ENOUGH_MEMORY	Во время обработки произошел сбой выделения.
ERROR_OBJECT_NOT_FOUND	Идентификатор объекта запроса библиотеки не найден. Эта ошибка возникает, если запрос выполнен до выдачи отмены или если указан недопустимый идентификатор запроса.
ERROR_SUCCESS	Запрос библиотеки поставлен в очередь для отмены.

Требования

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

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

EnumerateNtmsObject

Функции управления библиотекой

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