Compartilhar via

Método IPortableDeviceService::Advise (portabledeviceapi.h)

  • Artigo

O método Advise registra um objeto de retorno de chamada definido pelo aplicativo que recebe eventos de serviço.

Sintaxe

HRESULT Advise(
  [in]  const DWORD                  dwFlags,
  [in]  IPortableDeviceEventCallback *pCallback,
  [in]  IPortableDeviceValues        *pParameters,
  [out] LPWSTR                       *ppszCookie
);

Parâmetros

[in] dwFlags

Não usado.

[in] pCallback

A interface IPortableDeviceEventCallback especificando o objeto de retorno de chamada a ser registrado.

[in] pParameters

A interface IPortableDeviceValues que especifica os parâmetros de registro de evento ou NULL se o objeto de retorno de chamada deve receber todos os eventos de serviço.

[out] ppszCookie

A ID de contexto exclusiva para o objeto de retorno de chamada. Esse valor corresponde ao usado pelo método Unadvise para cancelar o registro do objeto de retorno de chamada.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_POINTER
 Um valor NULL foi especificado para o parâmetro pCallback ou o parâmetro ppszCookie .

Comentários

Durante a limpeza, um aplicativo deve cancelar o registro do objeto de retorno de chamada chamando o método Unadvise e liberar a memória referenciada pelo parâmetro ppszCookie chamando a função CoTaskMemFree .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho portabledeviceapi.h

Confira também

IPortableDeviceService Interface