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) |