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

Permite a un controlador proporcionar información de estado y error para todas las operaciones.

Sintaxis

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

Parámetros

[in] pfops

Tipo: IFileOperationProgressSink*

Puntero a un objeto IFileOperationProgressSink que se usará para el estado de progreso y las notificaciones de error.

[out] pdwCookie

Tipo: DWORD*

Cuando este método devuelve, este parámetro apunta 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 a IFileOperation::Unadvise. Si se produce un error en la llamada a Advise , este valor no tiene sentido.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Varios métodos individuales tienen la capacidad de declarar sus propios receptores de progreso, que son redundantes para el que se establece aquí. Se usan cuando solo se quiere proporcionar información de progreso y error para una operación específica.

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

Consulte también

IFileOperation

IFileOperation::Unadvise