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

  • Статья

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

Функция CancelNtmsOperatorRequest отменяет указанный запрос оператора RSM.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpRequestId

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

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
 Пользователь, который пытался выполнить эту функцию, не имеет прав администратора. Отменять запросы оператора может только администратор сервера RSM.
ERROR_INVALID_HANDLE
 Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Отсутствует идентификатор запроса.
ERROR_INVALID_STATE
 Запрос уже завершен или отменен.
ERROR_OBJECT_NOT_FOUND
 Идентификатор объекта запроса оператора не найден. Эта ошибка может возникнуть, если идентификатор запроса недопустим.
ERROR_SUCCESS
 Запрос оператора отменен.

Требования

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

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

Функции запроса оператора

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest