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

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

  • Статья

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

Функция SetNtmsRequestOrder задает порядок обработки указанного запроса в очереди библиотеки.

Синтаксис

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

Параметры

[in] hSession

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

[in] lpRequestId

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

[in] dwOrderNumber

Порядок обработки запроса в очереди.

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

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

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

Windows XP: Права доступа не требуются.
ERROR_DATABASE_FAILURE
 База данных недоступна или повреждена.
ERROR_INVALID_HANDLE
 Дескриптор сеанса отсутствует или недопустим.
ERROR_INVALID_PARAMETER
 Отсутствует идентификатор запроса библиотеки.
ERROR_OBJECT_NOT_FOUND
 Не удается найти объект запроса с указанным идентификатором.
ERROR_SUCCESS
 Функция выполнена успешно.

Комментарии

В настоящее время NTMS_LM_MOUNT запросы сортируются по номеру заказа.

Номер заказа, заданный функцией SetNtmsRequestOrder , зависит от типа запроса, так как типы обрабатываются в предопределенном порядке. Например, запрос NTMS_LM_DISMOUNT обрабатывается до запроса NTMS_LM_MOUNT. Однако в рамках определенного класса запросов очередь может быть упорядочена. В первую очередь обрабатываются запросы с более низкими упорядочениями; например, 1 — это первый обработанный запрос, 2 — следующий обработанный запрос и т. д.

Чтобы обработать запрос немедленно, приложение может задать номер заказа равным 1. Чтобы отложить обработку, приложение должно задать номер заказа очень большим числом или 0xFFFFFFFF. Порядковый номер запроса, у которого в настоящее время порядковый номер равен нулю, изменить нельзя.

Требования

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

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

GetNtmsRequestOrder

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