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

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

  • Статья

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

Функция DeleteNtmsRequests удаляет запрос или список запросов из базы данных RSM. Запросы библиотеки или оператора, которые находятся в состоянии завершения, сбоя, отказа или отмены, удаляются. Отправленные запросы, запросы в очереди, ожидающие запросы и выполняемые запросы не могут быть удалены.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpRequestId

Список идентификаторов библиотеки и запросов оператора на удаление.

[in] dwType

Тип запроса. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
NTMS_LIBREQUEST
 Запрос библиотеки.
NTMS_OPREQUEST
 Запрос оператора.

[in] dwCount

Количество запросов в списке.

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

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

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

Windows XP: NTMS_CONTROL_ACCESS на компьютер запрещено. Возможны и другие ошибки безопасности, но они указывают на ошибку подсистемы безопасности.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_DATABASE_FULL
 База данных заполнена.
ERROR_INVALID_PARAMETER
 Недопустимый идентификатор типа.
ERROR_INVALID_HANDLE
 Дескриптор сеанса отсутствует или недопустим.
ERROR_NOT_ENOUGH_MEMORY
 Сбой выделения памяти во время обработки.
ERROR_SUCCESS
 Функция успешно выполнена.

Комментарии

Ошибка не возвращается, если запрос или список запросов не найдены.

Требования

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

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

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