CInternetSession::OpenURL

Articolo
03/05/2013

Chiamare la funzione membro per inviare la richiesta specificata nel server HTTP e consentire al client specificare RFC822 aggiuntivo, il MIME, o intestazioni HTTP per inviare alla richiesta.

CStdioFile* OpenURL(
   LPCTSTR pstrURL,
   DWORD_PTR dwContext = 1,
   DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
   LPCTSTR pstrHeaders = NULL,
   DWORD dwHeadersLength = 0 
);

Parametri

pstrURL
Un puntatore al nome dell'URL per iniziare la lettura.Solo URL a partire da file:, da ftp:, gopher:, da o da HTTP: sono supportati.ASSERTS se lo pszURL è NULL.
dwContext
Un valore definito dall'applicazione viene passato agli handle restituiti dal callback.
dwFlags
Flag che descrivono come gestire questa connessione.Vedere Note per ulteriori informazioni sui flag validi.i flag validi sono:
- INTERNET_FLAG_TRANSFER_ASCII l'impostazione predefinita.Trasferire il file come testo ASCII.
- Trasferimento diINTERNET_FLAG_TRANSFER_BINARY il file come file binario.
- INTERNET_FLAG_RELOAD ottiene i dati dal responsabile anche se localmente nella cache.
- INTERNET_FLAG_DONT_CACHE non memorizza i dati nella cache, locale o in alcuni gateway.
- INTERNET_FLAG_SECURE questo flag è applicabile alle richieste HTTP solo.Richiede le transazioni sicure sull'associazione con Secure Sockets Layer) o il con.
- INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT se possibile, riutilizza le connessioni esistenti al server per le nuove richieste generate da OpenUrl anziché creare una nuova sessione per ogni richiesta di connessione.
- INTERNET_FLAG_PASSIVE utilizzato da un sito FTP.Utilizza la semantica passiva FTP.Utilizzato con CInternetConnectionOpenURL.
pstrHeaders
Un puntatore a una stringa contenente le intestazioni al server HTTP.
dwHeadersLength
La lunghezza, i caratteri, le intestazioni aggiuntive.Se è -1L e pstrHeaders èNULLnon, quindi pstrHeaders sia zero terminato e la lunghezza viene calcolata.

Valore restituito

Restituisce un handle di file per FTP, il GOPHER, HTTP e i servizi Internet del tipo di file solo.Restituisce NULL se l'analisi è l'operazione non è riuscita.

Il puntatore che restituisce OpenURL dipende dal tipo pszURLdi servizio.Nella tabella seguente vengono illustrati i puntatori a possibili OpenURL può restituire.

Tipo di URL	Valore restituito
file://	CStdioFile*
http://	CHttpFile*
gopher://	CGopherFile*
ftp://	CInternetFile*

Note

Il parametro dwFlags deve includere INTERNET_FLAG_TRANSFER_ASCII o INTERNET_FLAG_TRANSFER_BINARY, ma non entrambi.I flag restanti possono essere combinati con l'operatore bit per bit di ( OR**|**).

OpenURL, che esegue il wrapping della funzione Win32 InternetOpenURL, consente solo scaricare, recuperare e la lettura di dati da un server Internet.OpenURL non consente l'elaborazione di file in una posizione remota, pertanto non richiede oggetto CInternetConnection.

Per utilizzare ovvero le funzioni specifiche del protocollo connessione- specifiche, come la scrittura in un file, è necessario aprire una sessione, quindi si apre un particolare tipo di connessione, quindi di utilizzare tale connessione aprire un file in modalità desiderata.Vedere CInternetConnection per ulteriori informazioni sulle funzioni connessione- specifiche.