Função QOSCancel (qos2.h)
A função QOSCancel cancela uma operação sobreposta pendente, como QOSSetFlow.
Sintaxe
ExternC BOOL QOSCancel(
[in] HANDLE QOSHandle,
[in] LPOVERLAPPED Overlapped
);
Parâmetros
[in] QOSHandle
Manipule para o subsistema QOS retornado por QOSCreateHandle.
[in] Overlapped
Ponteiro para a estrutura OVERLAPPED usada na operação a ser cancelada.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será 0. Para obter informações de erro estendidas, chame GetLastError. Alguns códigos de erro possíveis seguem.
| Código de retorno | Descrição |
|---|---|
|
O parâmetro QOSHandle é inválido. |
|
O parâmetro Overlapped é inválido. |
|
Falha na alocação de memória. |
|
Não há recursos suficientes para executar a operação. |
|
Não foi possível executar a solicitação devido a um erro de dispositivo de E/S. |
|
O dispositivo indicado exige a reinicialização devido a erros de hardware. O aplicativo deve limpo e chamar QOSCreateHandle novamente. |
|
Ocorreu um erro de hardware do adaptador de rede. |
Comentários
Essa função nunca seria chamada com um parâmetro NULLSobreposto .
As operações canceladas com êxito completam mecanismos normais de conclusão e retornam ERROR_OPERATION_ABORTED como código de retorno de conclusão.
Fechar um identificador com o QOSCloseHandle anulará automaticamente todas as operações pendentes emitidas com esse identificador. Se o identificador estiver fechado enquanto um QOSCancel ainda estiver em andamento, a chamada será concluída com ERROR_OPERATION_ABORTED como o código de retorno.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | qos2.h (inclua Qos2.h) |
| Biblioteca | Qwave.lib |
| DLL | Qwave.dll |