Función GetNtmsRequestOrder (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 GetNtmsRequestOrder obtiene el orden en que se procesará la solicitud especificada en la cola de biblioteca.

Sintaxis

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

Parámetros

[in] hSession

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

[in] lpRequestId

Identificador único de una solicitud de biblioteca.

[out] lpdwOrderNumber

Orden en el que se procesará esta solicitud 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

Si la función GetNtmsRequestOrder devuelve cero en lpdwOrderNumber, la ordenación no está disponible para esta solicitud. El número de pedido es específico del tipo de solicitud porque los tipos se procesan en un orden predeterminado.

Por ejemplo, la 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. Las solicitudes ordenadas más bajas se procesan primero, por ejemplo, 1 es la primera solicitud procesada, 2 es la siguiente solicitud procesada, etc.

Puede usar este número de pedido, el tipo de solicitud, la hora de envío y la fecha de envío para ayudar a ver la cola en orden ordenado. El tipo de solicitud, el número de pedido y el tiempo de envío deben realizar la ordenación.

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

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

Funciones de control de biblioteca

SetNtmsRequestOrder