CInternetSession::OpenURL

Articolo
06/10/2015

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.