Metodo ITransferSource::Advise (shobjidl_core.h)

Articolo
08/26/2023

Configura una connessione di consulenza per le notifiche sullo stato delle operazioni file.

Sintassi

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Parametri

[in] psink

Tipo: ITransferAdviseSink*

Puntatore all'interfaccia di notifica ITransferAdviseSink per aggiornare l'applicazione chiamante usando metodi in questa interfaccia.

[out] pdwCookie

Tipo: DWORD*

Puntatore a un token restituito che identifica in modo univoco questa connessione. L'applicazione chiamante usa questo token in un secondo momento per eliminare la connessione passandola al metodo ITransferSource::Unadvise . Se la connessione non è stata stabilita correttamente, questo valore è zero.

Valore restituito

Tipo: HRESULT

Qualsiasi HRESULTs diverso da quello elencato indica un errore.

Codice restituito	Descrizione
S_OK	Interfaccia associata correttamente.
E_UNEXPECTED	Il gestore può gestire solo un'interfaccia sink.

Commenti

Chiamare ITransferSource::Consiglia prima di chiamare tutti gli altri metodi in questa interfaccia per abilitare una sessione di consulenza. Se non è impostato, il gestore deve considerarlo un'indicazione che non è disponibile alcun feedback e per eseguire l'operazione "predefinita" senza consultare l'applicazione chiamante.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite