Método IPortableDevice::Cancel (portabledeviceapi.h)

  • Artigo

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
S_OK
 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

Confira também

IPortableDevice Interface