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

  • Статья

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

Функция WaitForNtmsOperatorRequest ожидает указанного запроса оператора RSM.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpRequestId

Идентификатор запроса оператора, созданный функцией SubmitNtmsOperatorRequest .

[in] dwTimeout

Время ожидания в миллисекундах. Чтобы проверка для запроса оператора, передайте значение времени ожидания, равное нулю. Если указать значение INFINITE, время ожидания этой функции не истекает.

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

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

Значение Значение
ERROR_CANCELLED
 Запрос оператора был отменен администратором.
ERROR_INVALID_HANDLE
 Значение, указанное в параметре hSession , равно NULL или недопустимо.
ERROR_INVALID_PARAMETER
 Одно из значений параметра является недопустимым.
ERROR_NOT_CONNECTED
 Не удается подключиться к службе RSM.
ERROR_OBJECT_NOT_FOUND
 Не удается найти объект запроса оператора. Запросы объектов удаляются из базы данных. Приложение должно вызвать функцию , например AllocateNtmsMedia, если RSM возвращает эту ошибку.
ERROR_SUCCESS
 Функция выполнена успешно.
ERROR_TIMEOUT
 Время, указанное в параметре dwTimeout , прошло до завершения запроса оператора.

Комментарии

Запросы операторов, указанные с помощью функции WaitForNtmsOperatorRequest , используются для запроса носителя, перемещения среды из одной библиотеки в другую или для запроса службы устройств RSM.

Приложение использует WaitForNtmsOperatorRequest для ожидания разрешения запроса оператора. Запрос может быть удовлетворен, отклонен, удален или истекло время ожидания.

Как правило, приложения используют функцию SubmitNtmsOperatorRequest для отправки запросов операторов и функцию WaitForNtmsOperatorRequest для ожидания их разрешения.

Требования

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

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

CancelNtmsOperatorRequest

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

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest