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

Configura uma conexão de consultoria para notificações no status de operações de arquivo.

Sintaxe

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Parâmetros

[in] psink

Tipo: ITransferAdviseSink*

Um ponteiro para a interface de notificação ITransferAdviseSink para atualizar o aplicativo de chamada usando métodos nessa interface.

[out] pdwCookie

Tipo: DWORD*

Um ponteiro 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 o método ITransferSource::Unadvise . Se a conexão não tiver sido estabelecida com êxito, esse valor será zero.

Valor retornado

Tipo: HRESULT

Qualquer HRESULTs diferente de listados indica uma falha.

Comentários

Chame ITransferSource::Advise antes de chamar outros métodos nessa interface para habilitar uma sessão de consultoria. Se não estiver definido, o manipulador deverá considerar uma indicação de que nenhum comentário está disponível e fazer a operação "padrão" sem consultar o aplicativo de chamada.

Requisitos