Metodo IPortableDeviceService::Advise (portabledeviceapi.h)

Articolo
03/15/2023

Il metodo Advise registra un oggetto callback definito dall'applicazione che riceve gli eventi del servizio.

Sintassi

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

Parametri

[in] dwFlags

Non usato.

[in] pCallback

Interfaccia IPortableDeviceEventCallback che specifica l'oggetto callback da registrare.

[in] pParameters

Interfaccia IPortableDeviceValues che specifica i parametri di registrazione eventi o NULL se l'oggetto callback deve ricevere tutti gli eventi del servizio.

[out] ppszCookie

ID contesto univoco per l'oggetto di callback. Questo valore corrisponde a quello utilizzato dal metodo Unadvise per annullare la registrazione dell'oggetto callback.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	È stato specificato un valore NULL per il parametro pCallback o il parametro ppszCookie .

Commenti

Durante la pulizia, un'applicazione deve annullare la registrazione dell'oggetto callback chiamando il metodo Unadvise e quindi rilasciare la memoria a cui fa riferimento il parametro ppszCookie chiamando la funzione CoTaskMemFree .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h

Vedi anche

Interfaccia IPortableDeviceService

Condividi tramite