Funzione CfReportProviderProgress (cfapi.h)

Articolo
02/23/2024

Consente a un provider di sincronizzazione di segnalare lo stato di avanzamento fuori banda.

Sintassi

HRESULT CfReportProviderProgress(
  [in] CF_CONNECTION_KEY ConnectionKey,
  [in] CF_TRANSFER_KEY   TransferKey,
  [in] LARGE_INTEGER     ProviderProgressTotal,
  [in] LARGE_INTEGER     ProviderProgressCompleted
);

Parametri

[in] ConnectionKey

Chiave di connessione che rappresenta un canale di comunicazione con il filtro di sincronizzazione.

[in] TransferKey

Handle opaco per il segnaposto.

[in] ProviderProgressTotal

Stato totale del provider di sincronizzazione in risposta a un callback dei dati di recupero.

[in] ProviderProgressCompleted

Stato completato del provider di sincronizzazione in risposta a un callback dei dati di recupero.

Valore restituito

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

Commenti

Il filtro tiene automaticamente traccia dello stato di idratazione, monitorando gli intervalli trasferiti e/o riconosciuti in risposta a FETCH_DATA callback. Tuttavia, se un provider impiega la maggior parte del tempo durante il download del contenuto in una posizione temporanea prima di iniziare a TRANSFER_DATA al filtro, il filtro altrimenti non sa che queste attività sono in alcun modo correlate alla richiesta.

Chiamando periodicamente CfReportProviderProgress , il provider di sincronizzazione può segnalare lo stato di avanzamento del filtro, reimpostando così il periodo di timeout di 60 secondi corrispondente al callback CF_CALLBACK_TYPE_FETCH_DATA . Questo renderà anche più uniforme lo stato di avanzamento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cfapi.h
Libreria	CldApi.lib
DLL	CldApi.dll

Vedi anche

CfReportProviderProgress2

CF_CALLBACK_TYPE

Condividi tramite