Função SetNtmsRequestOrder (ntmsapi.h)

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

A função SetNtmsRequestOrder define a ordem em que a solicitação especificada será processada na fila da biblioteca.

Sintaxe

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

Parâmetros

[in] hSession

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

[in] lpRequestId

Identificador exclusivo de uma solicitação de biblioteca.

[in] dwOrderNumber

Ordene que a solicitação seja 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

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

O número da ordem definido pela função SetNtmsRequestOrder é específico para o tipo de solicitação porque os tipos são processados em uma ordem predeterminada. Por exemplo, uma solicitação de NTMS_LM_DISMOUNT é processada antes de uma solicitação de NTMS_LM_MOUNT. Em uma classe específica de solicitações, a fila pode ser ordenada, no entanto. 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.

Para processar uma solicitação imediatamente, um aplicativo pode definir o número do pedido como 1. Para adiar o processamento, um aplicativo deve definir o número do pedido como um número muito grande ou 0xFFFFFFFF. O número da ordem de uma solicitação, que atualmente tem um número de pedido zero, não pode ser alterado.

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

GetNtmsRequestOrder

Funções de controle de biblioteca