Método IPortableDevice::Cancel (portabledeviceapi.h)
O método Cancel cancela uma operação pendente nessa interface.
Sintaxe
HRESULT Cancel();
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
Código de retorno | Descrição |
---|---|
|
A operação foi cancelada com êxito. |
Comentários
Se o aplicativo invocar a API do WPD de vários threads, cada thread deverá criar uma nova instância da interface IPortableDevice . Isso garante que qualquer operação de cancelamento afete apenas a E/S do thread afetado.
Se uma operação de gravação IStream estiver em andamento quando o método Cancel for invocado, seu aplicativo deverá descartar todas as alterações invocando o método IStream::Revert . Depois que as alterações forem descartadas, o aplicativo também deverá fechar o fluxo invocando o método IUnknown::Release .
Além disso, observe que, se o método Cancel for invocado antes da conclusão de um método IStream::Write , os dados que estão sendo gravados poderão ser corrompidos.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | portabledeviceapi.h |
Biblioteca | PortableDeviceGUIDs.lib |