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 |
---|---|
|
A Interface associada com êxito. |
|
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) |