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

  • Artículo

El método Cancel cancela una operación pendiente en esta interfaz.

Sintaxis

HRESULT Cancel();

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 La operación se canceló correctamente.

Comentarios

Si la aplicación invoca la API de WPD desde varios subprocesos, cada subproceso debe crear una nueva instancia de la interfaz IPortableDevice . Esto garantiza que cualquier operación de cancelación afecte solo a la E/S del subproceso afectado.

Si hay una operación de escritura de IStream en curso cuando se invoca el método Cancel , la aplicación debe descartar todos los cambios invocando el método IStream::Revert . Una vez descartados los cambios, la aplicación también debe cerrar la secuencia invocando el método IUnknown::Release .

Además, tenga en cuenta que si se invoca el método Cancel antes de que se haya completado un método IStream::Write , los datos que se escriben pueden estar dañados.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado portabledeviceapi.h
Library PortableDeviceGUIDs.lib

Consulte también

IPortableDevice (Interfaz)