Función SetNtmsRequestOrder (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función SetNtmsRequestOrder establece el orden en que se procesará la solicitud especificada en la cola de biblioteca.

Sintaxis

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

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpRequestId

Identificador único de una solicitud de biblioteca.

[in] dwOrderNumber

Ordene que la solicitud se procese en la cola.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS al equipo se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.

Windows XP: No se requieren derechos de acceso.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 Falta el identificador de solicitud de biblioteca.
ERROR_OBJECT_NOT_FOUND
 No se encuentra un objeto de solicitud con el identificador especificado.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Actualmente, las solicitudes NTMS_LM_MOUNT se ordenan mediante el número de pedido.

El número de pedido establecido por la función SetNtmsRequestOrder es específico del tipo de solicitud porque los tipos se procesan en un orden predeterminado. Por ejemplo, una solicitud de NTMS_LM_DISMOUNT se procesa antes de una solicitud de NTMS_LM_MOUNT. Sin embargo, dentro de una clase específica de solicitudes, se puede ordenar la cola. Primero se procesan las solicitudes ordenadas más bajas; por ejemplo, 1 es la primera solicitud procesada, 2 es la siguiente solicitud procesada, etc.

Para procesar una solicitud inmediatamente, una aplicación puede establecer el número de pedido en 1. Para aplazar el procesamiento, una aplicación debe establecer el número de pedido en un número muy grande o 0xFFFFFFFF. No se puede cambiar el número de pedido de una solicitud, que actualmente tiene un número de pedido de cero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

GetNtmsRequestOrder

Funciones de control de biblioteca