Método ITransferDestination::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 uma 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 ITransferDestination::Unadvise . Se a conexão não for estabelecida com êxito, esse valor será zero.

Retornar valor

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 ITransferDestination::Advise antes de chamar qualquer outro método ITransferDestination para que o manipulador possa fazer o retorno de chamada para quaisquer erros que possam ocorrer. 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".

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)