Método ITransferSource::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 la 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 pasándola al método ITransferSource::Unadvise . Si la conexión no se estableció 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 de receptor.

Comentarios

Llame a ITransferSource::Advise antes de llamar a cualquier otro método de esta interfaz para habilitar una sesión de asesoramiento. Si no se establece, el controlador debe considerarlo una indicación de que no hay comentarios disponibles y de realizar la operación "predeterminada" sin consultar la aplicación que realiza la llamada.

Requisitos

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 (include Shobjidl.h)