Método IBackgroundCopyJob::SetNotifyInterface
Identifica a implementação da interface IBackgroundCopyCallback para a Otimização de Entrega. Use a interface IBackgroundCopyCallback para receber notificação de eventos relacionados ao trabalho.
Sintaxe
HRESULT SetNotifyInterface(
IUnknown *pNotifyInterface
);
Parâmetros
-
pNotifyInterface
-
Um ponteiro de interface IBackgroundCopyCallback . Para remover o ponteiro da interface de retorno de chamada atual, defina esse parâmetro como NULL.
Valor retornado
Esse método retorna os seguintes valores HRESULT , bem como outros.
| Código de retorno | Descrição |
|---|---|
|
O ponteiro da interface de notificação foi definido com êxito. |
Comentários
Chame esse método somente se você implementar a interface IBackgroundCopyCallback . Use o método SetNotifyInterface em conjunto com o método SetNotifyFlags para especificar o tipo de notificação que você deseja receber.
A interface de notificação torna-se inválida quando seu aplicativo é encerrado; A Otimização de Entrega não persiste a interface de notificação. Como resultado, o processo de inicialização do aplicativo deve chamar o método SetNotifyInterface nesses trabalhos existentes para os quais você deseja receber notificação. Se você precisar capturar informações de estado e progresso que ocorreram desde a última vez em que seu aplicativo foi executado, pesquise informações de estado e progresso durante a inicialização do aplicativo.
Somente o proprietário/criador do trabalho ou um administrador podem se registrar para notificações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server, versão 1709 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob é definido como 37668D37-507E-4160-9316-26306D150B12 |