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

  • Artigo

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.

Código de retorno Descrição
S_OK
 A Interface associada com êxito.
E_UNEXPECTED
 O manipulador só pode lidar com uma interface de coletor.

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

   
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)