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

Статья
08/25/2023

[Диспетчер съемных носителей больше недоступен в 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

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