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

El método Advise registra un objeto de devolución de llamada definido por la aplicación que recibe eventos de servicio.

Sintaxis

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

Parámetros

[in] dwFlags

No se usa.

[in] pCallback

La interfaz IPortableDeviceEventCallback que especifica el objeto de devolución de llamada que se va a registrar.

[in] pParameters

La interfaz IPortableDeviceValues que especifica los parámetros de registro de eventos o NULL si el objeto de devolución de llamada va a recibir todos los eventos de servicio.

[out] ppszCookie

Identificador de contexto único para el objeto de devolución de llamada. Este valor coincide con el usado por el método Unadvise para anular el registro del objeto de devolución de llamada.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	Se especificó un valor NULL para el parámetro pCallback o el parámetro ppszCookie .

Comentarios

Durante la limpieza, una aplicación debe anular el registro del objeto de devolución de llamada mediante una llamada al método Unadvise y, a continuación, liberar la memoria a la que hace referencia el parámetro ppszCookie mediante una llamada a la función CoTaskMemFree .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h

Consulte también

IPortableDeviceService (Interfaz)