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 |
|---|---|
|
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. |
|
O banco de dados está inacessível ou danificado. |
|
O identificador de sessão está ausente ou não é válido. |
|
O identificador de solicitação de biblioteca está ausente. |
|
Um objeto de solicitação com o identificador especificado não pode ser encontrado. |
|
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 |