Funzione InternetOpenUrlA (wininet.h)

Apre una risorsa specificata da un URL FTP o HTTP completo.

Sintassi

HINTERNET InternetOpenUrlA(
  [in] HINTERNET hInternet,
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszHeaders,
  [in] DWORD     dwHeadersLength,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parametri

[in] hInternet

Handle per la sessione Internet corrente. L'handle deve essere stato restituito da una chiamata precedente a InternetOpen.

[in] lpszUrl

Puntatore a una variabile stringa con terminazione Null che specifica l'URL da leggere. Sono supportati solo gli URL che iniziano con ftp:, http:o https: .

[in] lpszHeaders

Puntatore a una stringa con terminazione Null che specifica le intestazioni da inviare al server HTTP. Per altre informazioni, vedere la descrizione del parametro lpszHeaders nella funzione HttpSendRequest .

[in] dwHeadersLength

Dimensioni delle intestazioni aggiuntive, in TCHAR. Se questo parametro è -1L e lpszHeaders non è NULL, si presuppone che lpszHeaders sia con terminazione zero (ASCIIZ) e la lunghezza venga calcolata.

[in] dwFlags

Questo parametro può avere uno dei valori seguenti.

[in] dwContext

Puntatore a una variabile che specifica il valore definito dall'applicazione passato, insieme all'handle restituito, a qualsiasi funzione di callback.

Valore restituito

Restituisce un handle valido per l'URL se la connessione viene stabilita correttamente oppure NULL se la connessione non riesce. Per recuperare un messaggio di errore specifico, chiamare GetLastError. Per determinare il motivo per cui l'accesso al servizio è stato negato, chiamare InternetGetLastResponseInfo.

Commenti

Chiamare InternetCanonicalizeUrl prima se l'URL usato contiene un URL relativo e un URL di base separati da spazi vuoti.

Si tratta di una funzione generale che un'applicazione può usare per recuperare i dati su qualsiasi protocollo supportato da WinINet. Questa funzione è particolarmente utile quando l'applicazione non deve accedere ai particolari di un protocollo, ma richiede solo i dati corrispondenti a un URL. La funzione InternetOpenUrl analizza la stringa url, stabilisce una connessione al server e prepara a scaricare i dati identificati dall'URL. L'applicazione può quindi usare InternetReadFile (per i file) o InternetFindNextFile (per le directory) per recuperare i dati dell'URL. Non è necessario chiamare InternetConnect prima di InternetOpenUrl.

Windows XP e Windows Server 2003 R2 e versioni precedenti: InternetOpenUrl disabilita Gopher sulle porte inferiori a 1024, ad eccezione della porta 70, la porta Gopher standard e la porta 105, in genere usata per le ricerche dei nomi cso (Central Services Organization).

Dopo che l'applicazione chiamante ha terminato di utilizzare l'handle DELL'interfaccia UTENTE RESTITUITA da InternetOpenUrl, deve essere chiusa tramite la funzione InternetCloseHandle .

Nota Quando si lavora in modalità asincrona (il parametro dwFlags di InternetOpen specifica INTERNET_FLAG_ASYNC) e il parametro dwContext è zero (INTERNET_NO_CALLBACK), la funzione di callback impostata con InternetSetStatusCallback sull'handle di sessione non verrà richiamata, ma la chiamata verrà comunque eseguita in modalità asincrona

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

Gestione di localizzatori di risorse uniformi

Funzioni WinINet