Método IBackgroundCopyJob::SetNotifyInterface

Artículo
06/13/2023

Identifica la implementación de la interfaz IBackgroundCopyCallback en Optimización de distribución. Use la interfaz IBackgroundCopyCallback para recibir notificaciones de eventos relacionados con el trabajo.

Sintaxis

HRESULT SetNotifyInterface(
   IUnknown *pNotifyInterface
);

Parámetros

pNotifyInterface: Puntero de interfaz IBackgroundCopyCallback . Para quitar el puntero de la interfaz de devolución de llamada actual, establezca este parámetro en NULL.

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto	Descripción
S_OK	El puntero de la interfaz de notificación se estableció correctamente.

Observaciones

Llame a este método solo si implementa la interfaz IBackgroundCopyCallback . Use el método SetNotifyInterface junto con el método SetNotifyFlags para especificar el tipo de notificación que desea recibir.

La interfaz de notificación deja de ser válida cuando la aplicación finaliza; Optimización de distribución no conserva la interfaz de notificación. Como resultado, el proceso de inicialización de la aplicación debe llamar al método SetNotifyInterface en los trabajos existentes para los que desea recibir la notificación. Si necesita capturar información de estado y progreso que se produjo desde la última vez que se ejecutó la aplicación, sondee la información de estado y progreso durante la inicialización de la aplicación.

Solo el propietario o el creador del trabajo o un administrador pueden registrarse para recibir notificaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server, versión 1709 [solo aplicaciones de escritorio]
Encabezado	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Biblioteca	Dosvc.lib
Archivo DLL	Dosvc.dll
IID	IID_IBackgroundCopyJob se define como 37668D37-507E-4160-9316-26306D150B12

Consulte también

IBackgroundCopyJob
IBackgroundCopyCallback
IBackgroundCopyJob::GetNotifyInterface
IBackgroundCopyJob::SetNotifyFlags

Share via