Metodo IFileOperation::Advise (shobjidl_core.h)

Consente a un gestore di fornire informazioni sullo stato e sugli errori per tutte le operazioni.

Sintassi

HRESULT Advise(
  [in]  IFileOperationProgressSink *pfops,
  [out] DWORD                      *pdwCookie
);

Parametri

[in] pfops

Tipo: IFileOperationProgressSink*

Puntatore a un oggetto IFileOperationProgressSink da usare per le notifiche sullo stato di avanzamento e sugli errori.

[out] pdwCookie

Tipo: DWORD*

Quando termina, questo parametro punta 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 a IFileOperation::Unadvise. Se la chiamata a Advise ha esito negativo, questo valore è privo di significato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Diversi singoli metodi hanno la possibilità di dichiarare i propri sink di stato, ridondanti a quello impostato qui. Vengono usati quando si desidera fornire solo informazioni sullo stato di avanzamento e sull'errore per un'operazione specifica.

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)

Vedi anche

IFileOperation

IFileOperation::Unadvise