Método ITransferDestination::Advise (shobjidl_core.h)

Configura una conexión de asesoramiento para las notificaciones sobre el estado de las operaciones de archivo.

Sintaxis

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Parámetros

[in] psink

Tipo: ITransferAdviseSink*

Puntero a una interfaz de notificación ITransferAdviseSink para actualizar la aplicación que realiza la llamada mediante métodos en esta interfaz.

[out] pdwCookie

Tipo: DWORD*

Puntero a un token devuelto que identifica de forma única esta conexión. La aplicación que realiza la llamada usa este token más adelante para eliminar la conexión pasandola al método ITransferDestination::Unadvise . Si la conexión no se establece correctamente, este valor es cero.

Valor devuelto

Tipo: HRESULT

Cualquier HRESULT distinto de la lista indica un error.

Código devuelto	Descripción
S_OK	Interfaz asociada correctamente.
E_UNEXPECTED	El controlador solo puede controlar una interfaz receptora.

Comentarios

Llame a ITransferDestination::Advise antes de llamar a cualquier otro método ITransferDestination para que el controlador pueda realizar la devolución de llamada de los errores que puedan producirse. Si no se establece, el controlador debe considerarlo una indicación de que no hay comentarios disponibles y realizar la operación "predeterminada".

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)