Metodo ITransferDestination::Advise (shobjidl_core.h)

Articolo
03/02/2024

Configura una connessione consultiva per le notifiche sullo stato delle operazioni sui file.

Sintassi

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

Parametri

[in] psink

Tipo: ITransferAdviseSink*

Puntatore a un'interfaccia di notifica ITransferAdviseSink per aggiornare l'applicazione chiamante usando metodi su 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 ITransferDestination::Unadvise . Se la connessione non viene 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

Chiama ITransferDestination::Advise prima di chiamare qualsiasi altro metodo ITransferDestination in modo che il gestore possa eseguire il callback per eventuali errori che potrebbero verificarsi. Se non è impostato, il gestore deve considerarlo un'indicazione che non è disponibile alcun feedback ed eseguire l'operazione "predefinita".

Requisiti

Requisito	Valore
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