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) |