Funzione InternetSetStatusCallback (wininet.h)

La funzione InternetSetStatusCallback configura una funzione di callback che le funzioni WinINet possono chiamare durante un'operazione.

Sintassi

INTERNET_STATUS_CALLBACK InternetSetStatusCallback(
  [in] HINTERNET                hInternet,
  [in] INTERNET_STATUS_CALLBACK lpfnInternetCallback
);

Parametri

[in] hInternet

Handle per il quale viene impostato il callback.

[in] lpfnInternetCallback

Puntatore alla funzione di callback da chiamare quando viene eseguito lo stato di avanzamento oppure NULL per rimuovere la funzione di callback esistente. Per altre informazioni sulla funzione di callback, vedere InternetStatusCallback.

Valore restituito

Restituisce la funzione di callback di stato definita in precedenza se ha avuto esito positivo, NULL se non esiste una funzione di callback di stato definita in precedenza o INTERNET_INVALID_STATUS_CALLBACK se la funzione di callback non è valida.

Commenti

Entrambe le funzioni sincrone e asincrone usano la funzione di callback per indicare lo stato di avanzamento della richiesta, ad esempio la risoluzione di un nome, la connessione a un server e così via. La funzione di callback è necessaria per un'operazione asincrona. La richiesta asincrona verrà richiamata all'applicazione con INTERNET_STATUS_REQUEST_COMPLETE per indicare che la richiesta è stata completata.

Una funzione di callback può essere impostata su qualsiasi handle e viene ereditata da handle derivati. È possibile modificare una funzione di callback usando InternetSetStatusCallback, purché non siano presenti richieste in sospeso che devono usare il valore di callback precedente. Si noti, tuttavia, che la modifica della funzione di callback in un handle non modifica i callback negli handle derivati, ad esempio quelli restituiti da InternetConnect. È necessario modificare la funzione di callback a ogni livello.

Molte delle funzioni WinINet eseguono diverse operazioni sulla rete. Il completamento di ogni operazione può richiedere tempo e ogni operazione può avere esito negativo.

A volte è consigliabile visualizzare le informazioni sullo stato durante un'operazione a lungo termine. È possibile visualizzare le informazioni sullo stato configurando una funzione di callback di stato Internet che non può essere rimossa purché siano in sospeso qualsiasi callback o qualsiasi funzione asincrona.

Dopo l'avvio di InternetSetStatusCallback, è possibile accedere alla funzione di callback dall'interno di qualsiasi funzione WinINet per il monitoraggio di operazioni di rete a elevato utilizzo di tempo.

Nota La funzione di callback specificata nel parametro lpfnInternetCallback non verrà chiamata nelle operazioni asincrone per l'handle di richiesta quando il parametro dwContext di HttpOpenRequest è impostato su zero (INTERNET_NO_CALLBACK) o l'handle di connessione quando l'handle dwContext di InternetConnect è impostato su zero (INTERNET_NO_CALLBACK).

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Requisiti

Vedi anche

Funzioni comuni

InternetStatusCallback

Funzioni WinINet