Compartilhar via


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

Permite que um manipulador forneça status e informações de erro para todas as operações.

Sintaxe

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

Parâmetros

[in] pfops

Tipo: IFileOperationProgressSink*

Ponteiro para um objeto IFileOperationProgressSink a ser usado para progresso status e notificações de erro.

[out] pdwCookie

Tipo: DWORD*

Quando esse método retorna, esse parâmetro aponta para um token retornado que identifica exclusivamente essa conexão. O aplicativo de chamada usa esse token posteriormente para excluir a conexão passando-a para IFileOperation::Unadvise. Se a chamada para Aconselhar falhar, esse valor não tem sentido.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Vários métodos individuais têm a capacidade de declarar seus próprios coletores de progresso, que são redundantes para aquele definido aqui. Elas são usadas quando você só deseja obter informações de progresso e erro para uma operação específica.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

Ifileoperation

IFileOperation::Unadvise