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

Статья
11/20/2024

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

Функция SubmitNtmsOperatorRequest отправляет запрос оператора RSM.

Синтаксис

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Параметры

[in] hSession

Обработка сеанса, возвращаемого функцией OpenNtmsSess ion.

[in] dwRequest

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

Ценность	Значение
NTMS_OPREQ_CLEANER	RSM отправляет оператору запрос на вставку очистки, когда операция очистки находится в очереди, и для диска не доступно очистка. Параметр lpArg1Id может быть либо библиотекой, либо идентификатором слота. Требуется NTMS_CONTROL_ACCESS библиотеке. Windows XP: нет необходимых прав доступа.
NTMS_OPREQ_DEVICESERVICE	Приложение или RSM отправляет запрос оператора для службы дисков при возникновении проблем с устройством или диском. Параметр lpArg1Id указывает устройство, которому требуется служба. Этот параметр может быть идентификатором iedoor, библиотекой, физическим носителем или идентификатором диска. Требуется NTMS_CONTROL_ACCESS библиотеке. Windows XP: нет необходимых прав доступа.
NTMS_OPREQ_MESSAGE	Только сообщение приложения. Требуется NTMS_USE_ACCESS на компьютер. Windows XP: нет необходимых прав доступа.
NTMS_OPREQ_MOVEMEDIA	Приложение или RSM отправляет оператору запрос на перемещение мультимедиа из одной библиотеки в другую для подключения автономных носителей или извлечения существующих носителей в автономную библиотеку. Параметр lpArg1Id указывает часть физического носителя, которую необходимо переместить, а параметр lpArg2Id указывает целевую библиотеку. Требуется NTMS_CONTROL_ACCESS в пул носителей. Windows XP: нет необходимых прав доступа.
NTMS_OPREQ_NEWMEDIA	Приложение или RSM отправляет запрос оператора на новый носитель, если носитель недоступен. Параметр lpArg1Id указывает объект пула мультимедиа, а параметр lpArg2Id является необязательным идентификатором библиотеки, к которому добавляется новый носитель. Требуется NTMS_CONTROL_ACCESS в пул носителей. Windows XP: нет необходимых прав доступа.

[in] lpMessage

Необязательная строка сообщения, отправляемая пользователю.

[in] lpArg1Id

Идентификатор объекта для запроса оператора. Ознакомьтесь с описаниями значений в параметре dwRequest dwReque st, чтобы узнать, какой тип объекта необходимо передать для этого параметра.

[in] lpArg2Id

Идентификатор объекта для запроса оператора. Дополнительные сведения о том, какой тип объекта необходимо передать для этого параметра, см. в описаниях значений в параметре dwReque st dwRequest.

[out] lpRequestId

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

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

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

Ценность	Значение
ERROR_ACCESS_DENIED	Доступ к одному или нескольким объектам RSM запрещен.
ERROR_DATABASE_FAILURE	Сбой запроса или обновления базы данных.
ERROR_INVALID_HANDLE	Значение, указанное в параметре hSession , равно NULL или недопустимо.
ERROR_INVALID_PARAMETER	Одно из значений параметров недопустимо.
ERROR_NOT_CONNECTED	Не удается подключиться к службе RSM.
ERROR_OBJECT_NOT_FOUND	Не удается найти исходный или целевой объект.
ERROR_SUCCESS	Функция была успешной.

Замечания

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

Значение NTMS_OPEREQ_MESSAGE (в параметре dwRequest) чаще всего используется приложениями. RSM не может использовать NTMS_OPEREQ_MESSAGE. RSM использует другие типы запросов по мере необходимости.

Заметка

Заголовок ntmsapi.h определяет SubmitNtmsOperatorRequest как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntmsapi.h
библиотеки	Ntmsapi.lib
DLL	Ntmsapi.dll