Função GetNtmsRequestOrder (ntmsapi.h)

[O Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A função GetNtmsRequestOrder obtém a ordem em que a solicitação especificada será processada na fila da biblioteca.

Sintaxe

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

Parâmetros

[in] hSession

Manipule para a sessão retornada pela função OpenNtmsSession .

[in] lpRequestId

Identificador exclusivo de uma solicitação de biblioteca.

[out] lpdwOrderNumber

Ordem na qual essa solicitação será processada na fila.

Retornar valor

Essa função retorna um dos valores a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS para o computador é negado. Outros erros de segurança também são possíveis, mas indicam um erro de subsistema de segurança. Windows XP: Nenhum direito de acesso é necessário.
ERROR_DATABASE_FAILURE	O banco de dados está inacessível ou danificado.
ERROR_INVALID_HANDLE	O identificador de sessão está ausente ou não é válido.
ERROR_INVALID_PARAMETER	O identificador de solicitação de biblioteca está ausente.
ERROR_OBJECT_NOT_FOUND	Um objeto de solicitação com o identificador especificado não pode ser encontrado.
ERROR_SUCCESS	A função foi bem-sucedida.

Comentários

Se a função GetNtmsRequestOrder retornar zero em lpdwOrderNumber, a ordenação não estará disponível para essa solicitação. O número do pedido é específico para o tipo de solicitação porque os tipos são processados em uma ordem predeterminada.

Por exemplo, a solicitação de NTMS_LM_DISMOUNT é processada antes de uma solicitação de NTMS_LM_MOUNT. No entanto, dentro de uma classe específica de solicitações, a fila pode ser ordenada. As solicitações ordenadas inferiores são processadas primeiro, por exemplo, 1 é a primeira solicitação processada, 2 é a próxima solicitação processada e assim por diante.

Você pode usar esse número de pedido, o tipo de solicitação, a hora de envio e a data de envio para ajudar a exibir a fila em ordem classificada. O tipo de solicitação, o número do pedido e o tempo de envio devem executar a classificação.

Atualmente em NTMS_LM_MOUNT, as solicitações são classificadas usando o número do pedido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntmsapi.h
Biblioteca	Ntmsapi.lib
DLL	Ntmsapi.dll

Confira também

Funções de controle de biblioteca

SetNtmsRequestOrder