`CInternetSession`-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Hiermee maakt en initialiseert u één of meerdere gelijktijdige internetsessies en beschrijft u, indien nodig, uw verbinding met een proxyserver.

Syntaxis

class CInternetSession : public CObject

Leden

Openbare constructors

Naam	Description
`CInternetSession::CInternetSession`	Maakt een `CInternetSession` object.

Openbare methoden

Naam	Description
`CInternetSession::Close`	Hiermee sluit u de internetverbinding wanneer de internetverbinding wordt beëindigd.
`CInternetSession::EnableStatusCallback`	Hiermee wordt een terugbelroutine voor statussen vastgesteld.
`CInternetSession::GetContext`	Hiermee sluit u de internetverbinding wanneer de internetverbinding wordt beëindigd.
`CInternetSession::GetCookie`	Retourneert cookies voor de opgegeven URL en alle bovenliggende URL's.
`CInternetSession::GetCookieLength`	Haalt de variabele op die de lengte aangeeft van de cookie die in de buffer is opgeslagen.
`CInternetSession::GetFtpConnection`	Hiermee opent u een FTP-sessie met een server. Meldt zich aan bij de gebruiker.
`CInternetSession::GetGopherConnection`	Hiermee opent u een gopher-server voor een toepassing die een verbinding probeert te openen.
`CInternetSession::GetHttpConnection`	Hiermee opent u een HTTP-server voor een toepassing die een verbinding probeert te openen.
`CInternetSession::OnStatusCallback`	Hiermee wordt de status van een bewerking bijgewerkt wanneer de status callback is ingeschakeld.
`CInternetSession::OpenURL`	Parseert en opent een URL.
`CInternetSession::SetCookie`	Hiermee stelt u een cookie in voor de opgegeven URL.
`CInternetSession::SetOption`	Hiermee stelt u opties in voor de internetsessie.

Openbare operators

Naam	Description
`CInternetSession::operator HINTERNET`	Een ingang naar de huidige internetsessie.

Opmerkingen

Als uw internetverbinding moet worden onderhouden voor de duur van een toepassing, kunt u een CInternetSession lid van de klasse CWinAppmaken.

Zodra u een internetsessie tot stand hebt gebracht, kunt u bellen OpenURL. CInternetSession parseert vervolgens de URL voor u door de globale functie AfxParseURLaan te roepen. Ongeacht het protocoltype interpreteert CInternetSession u de URL en beheert u deze. Het kan aanvragen verwerken voor lokale bestanden die zijn geïdentificeerd met de URL-resource 'file://'. OpenURL retourneert een aanwijzer naar een CStdioFile object als de naam die u doorgeeft een lokaal bestand is.

Als u een URL op een internetserver opent met behulp OpenURLvan, kunt u informatie van de site lezen. Als u servicespecifieke acties (bijvoorbeeld HTTP, FTP of gopher) wilt uitvoeren op bestanden die zich op een server bevinden, moet u de juiste verbinding met die server tot stand brengen. Als u een bepaald type verbinding rechtstreeks met een bepaalde service wilt openen, gebruikt u een van de volgende lidfuncties:

GetGopherConnection om een verbinding met een gopher-service te openen.
GetHttpConnection om een verbinding met een HTTP-service te openen.
GetFtpConnection om een verbinding met een FTP-service te openen.

SetOption hiermee kunt u de queryopties van uw sessie instellen, zoals time-outwaarden, aantal nieuwe pogingen, enzovoort.

CInternetSession lidfuncties SetCookie, GetCookieen GetCookieLength bieden de middelen voor het beheren van een Win32-cookiedatabase, waarmee servers en scripts statusinformatie over het clientwerkstation onderhouden.

Zie het artikel Internet First Steps voor meer informatie over basistaken voor internetprogrammering: WinInet. Zie het artikel Internetprogrammering met WinInetvoor algemene informatie over het gebruik van de MFC-klassenWinInet.

Opmerking

CInternetSession genereert een AfxThrowNotSupportedException voor niet-ondersteunde servicetypen. Alleen de volgende servicetypen worden momenteel ondersteund: FTP, HTTP, gopher en bestand.

Overnamehiërarchie

CObject
CInternetSession

Requirements

Rubriek:afxinet.h

`CInternetSession::CInternetSession`

Deze lidfunctie wordt aangeroepen wanneer een CInternetSession object wordt gemaakt.

CInternetSession(
    LPCTSTR pstrAgent = NULL,
    DWORD_PTR dwContext = 1,
    DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
    LPCTSTR pstrProxyName = NULL,
    LPCTSTR pstrProxyBypass = NULL,
    DWORD dwFlags = 0);

Parameterwaarden

pstrAgent
Een aanwijzer naar een tekenreeks die de naam van de toepassing of entiteit aanroept die de internetfuncties aanroept (bijvoorbeeld 'Microsoft Internet Browser'). Als pstrAgent dit is NULL (de standaardinstelling), roept het framework de globale functie AfxGetAppNameaan, die een null-beëindigde tekenreeks retourneert die de naam van een toepassing bevat. Sommige protocollen gebruiken deze tekenreeks om uw toepassing op de server te identificeren.

dwContext
De context-id voor de bewerking. dwContext identificeert de statusinformatie van de bewerking die wordt geretourneerd door CInternetSession::OnStatusCallback. De standaardwaarde is ingesteld op 1; U kunt echter expliciet een specifieke context-id toewijzen voor de bewerking. Het object en alle werkzaamheden die het doet, worden gekoppeld aan die context-id.

dwAccessType
Het vereiste type toegang. Hier volgen geldige waarden, waarvan er precies één kan worden opgegeven:

INTERNET_OPEN_TYPE_PRECONFIG Verbinding maken met vooraf geconfigureerde instellingen in het register. Dit toegangstype is ingesteld als de standaardinstelling. Als u verbinding wilt maken via een TIS-proxy, stelt u deze waarde in dwAccessType . Vervolgens stelt u het register op de juiste manier in.
INTERNET_OPEN_TYPE_DIRECT Maak rechtstreeks verbinding met internet.
INTERNET_OPEN_TYPE_PROXY Verbinding maken via een CERN-proxy.

Zie Stappen in een typische FTP-clienttoepassing voor meer informatie over het maken van verbinding met verschillende typen proxy's.

pstrProxyName
De naam van de voorkeurs-CERN-proxy als dwAccessType deze is ingesteld als INTERNET_OPEN_TYPE_PROXY. De standaardwaarde is NULL.

pstrProxyBypass
Een aanwijzer naar een tekenreeks met een optionele lijst met serveradressen. Deze adressen kunnen worden overgeslagen wanneer u proxytoegang gebruikt. Als er een NULL waarde wordt opgegeven, wordt de bypass-lijst gelezen uit het register. Deze parameter is alleen zinvol als dwAccessType deze is ingesteld op INTERNET_OPEN_TYPE_PROXY.

dwFlags
Geeft verschillende cacheopties aan. De standaardwaarde is ingesteld op 0. De mogelijke waarden zijn:

INTERNET_FLAG_DONT_CACHE Sla de gegevens niet in de cache op, lokaal of op gatewayservers.
INTERNET_FLAG_OFFLINE Downloadbewerkingen worden alleen uitgevoerd via de permanente cache. Als het item niet in de cache bestaat, wordt een juiste foutcode geretourneerd. Deze vlag kan worden gecombineerd met de bitsgewijze operator 'or' (|).

Opmerkingen

CInternetSession is de eerste internetfunctie die wordt aangeroepen door een toepassing. Hiermee worden interne gegevensstructuren geïnitialiseerd en worden toekomstige aanroepen vanuit de toepassing voorbereid.

Als er geen internetverbinding kan worden geopend, CInternetSession werpt u een AfxThrowInternetException.

Example

Zie het voorbeeld voor CFtpFileFind.

`CInternetSession::Close`

Roep deze lidfunctie aan wanneer uw toepassing klaar is met het CInternetSession object.

virtual void Close();

Example

Zie het voorbeeld voor CFtpFileFind.

`CInternetSession::EnableStatusCallback`

Roep deze lidfunctie aan om status callback in te schakelen.

BOOL EnableStatusCallback(BOOL bEnable = TRUE);

Parameterwaarden

bEnable
Hiermee geeft u op of callback is ingeschakeld of uitgeschakeld. De standaardwaarde is TRUE.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als de aanroep mislukt, bepaalt u de oorzaak van de fout door het gegenereerde CInternetException object te onderzoeken.

Opmerkingen

Bij het verwerken van de callback van statussen kunt u status opgeven over de voortgang van de bewerking (zoals het omzetten van de naam, verbinding maken met de server, enzovoort) in de statusbalk van de toepassing. Het weergeven van de bewerkingsstatus is vooral wenselijk tijdens een langdurige bewerking.

Omdat callbacks optreden tijdens de verwerking van de aanvraag, moet de toepassing zo weinig mogelijk tijd besteden aan de callback om de afname van de gegevensdoorvoer naar het netwerk te voorkomen. Het inschakelen van een dialoogvenster in een callback kan bijvoorbeeld een lange bewerking zijn die de server de aanvraag beëindigt.

De statusaanroep kan niet worden verwijderd zolang er callbacks in behandeling zijn.

Als u bewerkingen asynchroon wilt afhandelen, moet u uw eigen thread maken of de WinInet-functies gebruiken zonder MFC.

`CInternetSession::GetContext`

Roep deze lidfunctie aan om de contextwaarde voor een bepaalde toepassingssessie op te halen.

DWORD_PTR GetContext() const;

Retourwaarde

De door de toepassing gedefinieerde context-id.

Opmerkingen

OnStatusCallback gebruikt de context-id die wordt geretourneerd om GetContext de status van een bepaalde toepassing te rapporteren. Wanneer een gebruiker bijvoorbeeld een internetaanvraag activeert waarbij statusgegevens worden geretourneerd, gebruikt de terugbeloproep van de status de context-id om de status van die specifieke aanvraag te rapporteren. Als de gebruiker twee afzonderlijke internetaanvragen activeert waarbij beide statusinformatie moeten worden geretourneerd, OnStatusCallback gebruikt u de context-id's om de status over de bijbehorende aanvragen te retourneren. De context-id wordt daarom gebruikt voor alle statusaanroepbewerkingen en is gekoppeld aan de sessie totdat de sessie is beëindigd.

Zie het artikel Internet First Steps: WinInet voor meer informatie over asynchrone bewerkingen.

`CInternetSession::GetCookie`

Deze lidfunctie implementeert het gedrag van de Win32-functie InternetGetCookie, zoals beschreven in de Windows SDK.

static BOOL GetCookie(
    LPCTSTR pstrUrl,
    LPCTSTR pstrCookieName,
    LPTSTR pstrCookieData,
    DWORD dwBufLen);

static BOOL GetCookie(
    LPCTSTR pstrUrl,
    LPCTSTR pstrCookieName,
    CString& strCookieData);

Parameterwaarden

pstrUrl
Een aanwijzer naar een tekenreeks die de URL bevat.

pstrCookieName
Een aanwijzer naar een tekenreeks met de naam van de cookie die moet worden getypeerd voor de opgegeven URL.

pstrCookieData
Bij de eerste overbelasting wijst u een aanwijzer naar een tekenreeks die het adres bevat van de buffer die de cookiegegevens ontvangt. Deze waarde kan zijn NULL. In de tweede overbelasting verwijst u naar een CString object om de cookiegegevens te ontvangen.

dwBufLen
De variabele die de grootte van de pstrCookieData buffer aangeeft. Als de functie slaagt, ontvangt de buffer de hoeveelheid gegevens die naar de pstrCookieData buffer zijn gekopieerd. Als pstrCookieData dat het is NULL, ontvangt deze parameter een waarde die de grootte van de buffer aangeeft die nodig is om alle cookiegegevens te kopiëren.

Retourwaarde

Retourneert TRUE indien geslaagd of FALSE anderszins. Als de aanroep mislukt, roept u de Win32-functie GetLastError aan om de oorzaak van de fout te bepalen. De volgende foutwaarden zijn van toepassing:

ERROR_NO_MORE_ITEMS Er is geen cookie voor de opgegeven URL en alle bijbehorende ouders.
ERROR_INSUFFICIENT_BUFFER De doorgegeven dwBufLen waarde is onvoldoende om alle cookiegegevens te kopiëren. De geretourneerde dwBufLen waarde is de grootte van de buffer die nodig is om alle gegevens op te halen.

Opmerkingen

Bij de tweede overbelasting haalt MFC de cookiegegevens op in het opgegeven CString object.

`CInternetSession::GetCookieLength`

Roep deze lidfunctie aan om de lengte van de cookie op te halen die in de buffer is opgeslagen.

static DWORD GetCookieLength(
    LPCTSTR pstrUrl,
    LPCTSTR pstrCookieName);

Parameterwaarden

pstrUrl
Een aanwijzer naar een tekenreeks die de URL bevat

pstrCookieName
Een aanwijzer naar een tekenreeks met de naam van de cookie.

Retourwaarde

Een DWORD waarde die de lengte van de cookie aangeeft, opgeslagen in de buffer. Nul als er geen cookie is met de naam die wordt aangegeven.pstrCookieName

Opmerkingen

Deze waarde wordt gebruikt door GetCookie.

`CInternetSession::GetFtpConnection`

Roep deze lidfunctie aan om een FTP-verbinding tot stand te brengen en een aanwijzer op te halen naar een CFtpConnection object.

CFtpConnection* GetFtpConnection(
    LPCTSTR pstrServer,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    BOOL bPassive = FALSE);

Parameterwaarden

pstrServer
Een aanwijzer naar een tekenreeks met de naam van de FTP-server.

pstrUserName
Aanwijzer naar een door null beëindigde tekenreeks waarmee de naam van de gebruiker wordt opgegeven die moet worden aangemeld. Als NULLde standaardwaarde anoniem is.

pstrPassword
Een aanwijzer naar een door null beëindigde tekenreeks waarmee het wachtwoord wordt opgegeven dat moet worden gebruikt om u aan te melden. Als beide pstrPassword en pstrUserName beide zijn NULL, is het standaard anonieme wachtwoord de e-mailadresnaam van de gebruiker. Als pstrPassword dit een (of een lege tekenreeks) is NULL , maar pstrUserName dit niet NULLis, wordt een leeg wachtwoord gebruikt. In de volgende tabel wordt het gedrag voor de vier mogelijke instellingen van pstrUserName en pstrPassword:

`pstrUserName`	`pstrPassword`	Gebruikersnaam verzonden naar FTP-server	Wachtwoord verzonden naar FTP-server
`NULL` of `" "`	`NULL` of `" "`	`"anonymous"`	E-mailnaam van gebruiker
Niet-tekenreeks`NULL`	`NULL` of `" "`	`pstrUserName`	" "
`NULL`	Niet-tekenreeks`NULL`	ERROR	ERROR
Niet-tekenreeks`NULL`	Niet-tekenreeks`NULL`	`pstrUserName`	`pstrPassword`

nPort
Een getal dat de TCP/IP-poort identificeert die op de server moet worden gebruikt.

bPassive
Hiermee geeft u de passieve of actieve modus voor deze FTP-sessie. Als deze optie is ingesteld TRUE, wordt de Win32-API dwFlag ingesteld op INTERNET_FLAG_PASSIVE.

Retourwaarde

Een aanwijzer naar een CFtpConnection object. Als de aanroep mislukt, bepaalt u de oorzaak van de fout door het gegenereerde CInternetException object te onderzoeken.

Opmerkingen

GetFtpConnection maakt verbinding met een FTP-server en maakt en retourneert een aanwijzer naar een CFTPConnection object. Er wordt geen specifieke bewerking uitgevoerd op de server. Als u bijvoorbeeld bestanden wilt lezen of schrijven, moet u deze bewerkingen uitvoeren als afzonderlijke stappen. Zie de klassen CFtpConnection en CFtpFileFind voor informatie over het zoeken naar bestanden, het openen van bestanden en het lezen of schrijven naar bestanden. Zie het artikel Internetprogrammeren met WinInet voor stappen bij het uitvoeren van algemene FTP-verbindingstaken.

Example

Zie het voorbeeld voor CFtpFileFind.

`CInternetSession::GetGopherConnection`

Roep deze lidfunctie aan om een nieuwe gopher-verbinding tot stand te brengen en een aanwijzer op te halen naar een CGopherConnection object.

CGopherConnection* GetGopherConnection(
    LPCTSTR pstrServer,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

Parameterwaarden

pstrServer
Een aanwijzer naar een tekenreeks met de naam van de gopher-server.

pstrUserName
Een aanwijzer naar een tekenreeks met de gebruikersnaam.

pstrPassword
Een aanwijzer naar een tekenreeks met het toegangswachtwoord.

nPort
Een getal dat de TCP/IP-poort identificeert die op de server moet worden gebruikt.

Retourwaarde

Een aanwijzer naar een CGopherConnection object. Als de aanroep mislukt, bepaalt u de oorzaak van de fout door het gegenereerde CInternetException object te onderzoeken.

Opmerkingen

GetGopherConnection maakt verbinding met een gopher-server en maakt en retourneert een aanwijzer naar een CGopherConnection object. Er wordt geen specifieke bewerking uitgevoerd op de server. Als u bijvoorbeeld gegevens wilt lezen of schrijven, moet u deze bewerkingen uitvoeren als afzonderlijke stappen. Zie de klassen CGopherConnection, CGopherFileen CGopherFileFind voor informatie over het zoeken naar bestanden, het openen van bestanden en het lezen of schrijven naar bestanden. Zie de lidfunctie OpenURLvoor informatie over het bladeren door een FTP-site. Zie het artikel Internetprogrammeren met WinInet voor stappen bij het uitvoeren van algemene gopher-verbindingstaken.

`CInternetSession::GetHttpConnection`

Roep deze lidfunctie aan om een HTTP-verbinding tot stand te brengen en een aanwijzer op te halen naar een CHttpConnection object.

CHttpConnection* GetHttpConnection(
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL);

CHttpConnection* GetHttpConnection(
    LPCTSTR pstrServer,
    DWORD dwFlags,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL);

Parameterwaarden

pstrServer
Een aanwijzer naar een tekenreeks met de naam van de HTTP-server.

nPort
Een getal dat de TCP/IP-poort identificeert die op de server moet worden gebruikt.

pstrUserName
Een aanwijzer naar een tekenreeks met de gebruikersnaam.

pstrPassword
Een aanwijzer naar een tekenreeks met het toegangswachtwoord.

dwflags
Elke combinatie van de INTERNET_FLAG_* vlaggen. Zie de tabel in de sectie Opmerkingen van CHttpConnection::OpenRequest voor een beschrijving van dwFlags waarden.

Retourwaarde

Een aanwijzer naar een CHttpConnection object. Als de aanroep mislukt, bepaalt u de oorzaak van de fout door het gegenereerde CInternetException object te onderzoeken.

Opmerkingen

GetHttpConnection maakt verbinding met een HTTP-server en maakt en retourneert een aanwijzer naar een CHttpConnection object. Er wordt geen specifieke bewerking uitgevoerd op de server. Als u bijvoorbeeld een query wilt uitvoeren op een HTTP-header, moet u deze bewerking als een afzonderlijke stap uitvoeren. Zie de klassen en CHttpFile voor informatie over bewerkingen CHttpConnection die u kunt uitvoeren met behulp van een verbinding met een HTTP-server. Zie de lidfunctie OpenURLvoor informatie over het bladeren door een HTTP-site. Zie het artikel Internetprogrammeren met WinInet voor stappen bij het uitvoeren van algemene HTTP-verbindingstaken.

`CInternetSession::OnStatusCallback`

Deze lidfunctie wordt aangeroepen door het framework om de status bij te werken wanneer status callback is ingeschakeld en een bewerking in behandeling is.

virtual void OnStatusCallback(
    DWORD_PTR dwContext,
    DWORD dwInternetStatus,
    LPVOID lpvStatusInformation,
    DWORD dwStatusInformationLength);

Parameterwaarden

dwContext
De contextwaarde die door de toepassing wordt geleverd.

dwInternetStatus
Een statuscode die aangeeft waarom de callback wordt uitgevoerd. Zie Opmerkingen voor een tabel met mogelijke waarden.

lpvStatusInformation
Een aanwijzer naar een buffer met informatie die relevant is voor deze callback.

dwStatusInformationLength
De grootte van lpvStatusInformation.

Opmerkingen

U moet eerst aanroepen EnableStatusCallback om te profiteren van statusaanroep.

De dwInternetStatus parameter geeft de bewerking aan die wordt uitgevoerd en bepaalt wat de inhoud lpvStatusInformation is. dwStatusInformationLength geeft de lengte aan van de gegevens die zijn opgenomen in lpvStatusInformation. De volgende statuswaarden dwInternetStatus zijn als volgt gedefinieerd:

Waarde	Meaning
`INTERNET_STATUS_RESOLVING_NAME`	Het IP-adres opzoeken van de naam in `lpvStatusInformation`.
`INTERNET_STATUS_NAME_RESOLVED`	Het IP-adres van de naam gevonden in `lpvStatusInformation`.
`INTERNET_STATUS_CONNECTING_TO_SERVER`	Verbinding maken met het socketadres (`SOCKADDR`) waarnaar wordt verwezen door `lpvStatusInformation`.
`INTERNET_STATUS_CONNECTED_TO_SERVER`	Verbinding gemaakt met het socketadres (`SOCKADDR`) waarnaar wordt verwezen door `lpvStatusInformation`.
`INTERNET_STATUS_SENDING_REQUEST`	De informatieaanvraag verzenden naar de server. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_REQUEST_SENT`	De informatieaanvraag is verzonden naar de server. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_RECEIVING_RESPONSE`	Wacht tot de server reageert op een aanvraag. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_RESPONSE_RECEIVED`	Er is een antwoord ontvangen van de server. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_CLOSING_CONNECTION`	Sluit de verbinding met de server. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_CONNECTION_CLOSED`	De verbinding met de server is verbroken. De `lpvStatusInformation` parameter is `NULL`.
`INTERNET_STATUS_HANDLE_CREATED`	Wordt gebruikt door de Win32-API-functie `InternetConnect` om aan te geven dat de nieuwe ingang is gemaakt. Hierdoor kan de toepassing de Win32-functie `InternetCloseHandle` aanroepen vanuit een andere thread als de verbinding te lang duurt. Zie de Windows SDK voor meer informatie over deze functies.
`INTERNET_STATUS_HANDLE_CLOSING`	Deze ingangswaarde is beëindigd.

Overschrijf deze lidfunctie om actie te vereisen voordat een status callback-routine wordt uitgevoerd.

Opmerking

Status callbacks hebben thread-state protection nodig. Als u MFC in een gedeelde bibliotheek gebruikt, voegt u de volgende regel toe aan het begin van de onderdrukking:

AFX_MANAGE_STATE(AfxGetAppModuleState());

Zie het artikel Internet First Steps: WinInet voor meer informatie over asynchrone bewerkingen.

`CInternetSession::OpenURL`

Roep deze lidfunctie aan om de opgegeven aanvraag naar de HTTP-server te verzenden en de client toe te staan aanvullende RFC822-, MIME- of HTTP-headers op te geven die samen met de aanvraag moeten worden verzonden.

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

Parameterwaarden

pstrURL
Een aanwijzer naar de naam van de URL om te beginnen met lezen. Alleen URL's die beginnen metfile:, ftp:of http:gopher:worden ondersteund. Asserts if pstrURL is NULL.

dwContext
Een door de toepassing gedefinieerde waarde die is doorgegeven met de geretourneerde ingang in callback.

dwFlags
De vlaggen die beschrijven hoe deze verbinding moet worden verwerkt. Zie Opmerkingen voor meer informatie over de geldige vlaggen. De geldige vlaggen zijn:

INTERNET_FLAG_TRANSFER_ASCII De standaardwaarde. Draag het bestand over als ASCII-tekst.
INTERNET_FLAG_TRANSFER_BINARY Breng het bestand over als een binair bestand.
INTERNET_FLAG_RELOAD Haal de gegevens van de kabel op, zelfs als deze lokaal in de cache zijn opgeslagen.
INTERNET_FLAG_DONT_CACHE Sla de gegevens niet in de cache op, lokaal of in gateways.
INTERNET_FLAG_SECURE Deze vlag is alleen van toepassing op HTTP-aanvragen. Er worden beveiligde transacties op de kabel aangevraagd met Secure Sockets Layer of PCT.
INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT Gebruik indien mogelijk de bestaande verbindingen met de server opnieuw voor nieuwe aanvragen die worden gegenereerd door OpenUrl in plaats van een nieuwe sessie te maken voor elke verbindingsaanvraag.
INTERNET_FLAG_PASSIVE Wordt gebruikt voor een FTP-site. Maakt gebruik van passieve FTP-semantiek. Gebruikt met CInternetConnection .OpenURL

pstrHeaders
Een aanwijzer naar een tekenreeks die de headers bevat die naar de HTTP-server moeten worden verzonden.

dwHeadersLength
De lengte, in tekens, van de extra kopteksten. Als dit het niet is-1LNULL, pstrHeaderspstrHeaders wordt ervan uitgegaan dat nul wordt beëindigd en de lengte wordt berekend.

Retourwaarde

Retourneert alleen een bestandsingang voor FTP-, GOPHER-, HTTP- en BESTANDSTYPE-internetservices. Retourneert NULL als parseren is mislukt.

De aanwijzer die OpenURL retourneert, is afhankelijk pstrURLvan het type service. In de onderstaande tabel ziet u de mogelijke aanwijzingen OpenURL die kunnen worden geretourneerd.

URL-type	Retouren
`file://`	`CStdioFile*`
`http://`	`CHttpFile*`
`gopher://`	`CGopherFile*`
`ftp://`	`CInternetFile*`

Opmerkingen

De parameter dwFlags moet een of INTERNET_FLAG_TRANSFER_ASCIIINTERNET_FLAG_TRANSFER_BINARY, maar niet beide bevatten. De resterende vlaggen kunnen worden gecombineerd met de operator bitwise 'or' (|).

OpenURL, waarmee de Win32-functie InternetOpenURLwordt verpakt, kan alleen de gegevens van een internetserver worden gedownload, opgehaald en gelezen. OpenURL staat geen bestandsbewerking toe op een externe locatie, dus hiervoor is geen CInternetConnection object vereist.

Als u verbindingsspecifieke functies (dat wil gezegd protocolspecifiek) wilt gebruiken, zoals schrijven naar een bestand, moet u een sessie openen en vervolgens een bepaald type verbinding openen en die verbinding vervolgens gebruiken om een bestand in de gewenste modus te openen. Zie CInternetConnection voor meer informatie over verbindingsspecifieke functies.

`CInternetSession::operator HINTERNET`

Gebruik deze operator om de Windows-ingang voor de huidige internetsessie op te halen.

operator HINTERNET() const;

`CInternetSession::SetCookie`

Hiermee stelt u een cookie in voor de opgegeven URL.

static BOOL SetCookie(
    LPCTSTR pstrUrl,
    LPCTSTR pstrCookieName,
    LPCTSTR pstrCookieData);

Parameterwaarden

pstrUrl
Een aanwijzer naar een door null beëindigde tekenreeks die de URL aangeeft waarvoor de cookie moet worden ingesteld.

pstrCookieName
Een aanwijzer naar een tekenreeks met de naam van de cookie.

pstrCookieData
Een aanwijzer naar een tekenreeks met de werkelijke tekenreeksgegevens die moeten worden gekoppeld aan de URL.

Retourwaarde

Retourneert TRUE indien geslaagd of FALSE anderszins. Als u de specifieke foutcode wilt ophalen, roept u het aan GetLastError.

Opmerkingen

Deze lidfunctie implementeert het gedrag van het Win32-bericht InternetSetCookie, zoals beschreven in de Windows SDK.

`CInternetSession::SetOption`

Roep deze lidfunctie aan om opties in te stellen voor de internetsessie.

BOOL SetOption(
    DWORD dwOption,
    LPVOID lpBuffer,
    DWORD dwBufferLength,
    DWORD dwFlags = 0);

BOOL SetOption(
    DWORD dwOption,
    DWORD dwValue,
    DWORD dwFlags = 0);

Parameterwaarden

dwOption
De internetoptie die moet worden ingesteld. Zie Optievlagken in de Windows SDK voor een lijst met mogelijke opties.

lpBuffer
Een buffer die de optie-instelling bevat.

dwBufferLength
De lengte van lpBuffer of de grootte van dwValue.

dwValue
Een DWORD met de optie-instelling.

dwFlags
Geeft verschillende cacheopties aan. De standaardwaarde is ingesteld op 0. De mogelijke waarden zijn:

INTERNET_FLAG_DONT_CACHE Sla de gegevens niet in de cache op, lokaal of op gatewayservers.
INTERNET_FLAG_OFFLINE Downloadbewerkingen worden alleen uitgevoerd via de permanente cache. Als het item niet in de cache bestaat, wordt een juiste foutcode geretourneerd. Deze vlag kan worden gecombineerd met de bitsgewijze operator 'or' (|).

Retourwaarde

Als de bewerking is geslaagd, wordt een waarde geretourneerd van TRUE . Als er een fout is opgetreden, wordt een waarde geretourneerd.FALSE Als de aanroep mislukt, kan de Win32-functie GetLastError worden aangeroepen om de oorzaak van de fout te bepalen.

Zie ook

CObject klasse
Hiërarchiegrafiek
CInternetConnection klasse
CHttpConnection klasse
CFtpConnection klasse
CGopherConnection klasse

Feedback

Is deze pagina nuttig?

Last updated on 2026-02-23

Share via

CInternetSession-klasse

Syntaxis

Leden

Openbare constructors

Openbare methoden

Openbare operators

Opmerkingen

Overnamehiërarchie

Requirements

CInternetSession::CInternetSession

Parameterwaarden

Opmerkingen

Example

CInternetSession::Close

Example

CInternetSession::EnableStatusCallback

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::GetContext

Retourwaarde

Opmerkingen

CInternetSession::GetCookie

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::GetCookieLength

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::GetFtpConnection

Parameterwaarden

Retourwaarde

Opmerkingen

Example

CInternetSession::GetGopherConnection

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::GetHttpConnection

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::OnStatusCallback

Parameterwaarden

Opmerkingen

CInternetSession::OpenURL

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::operator HINTERNET

CInternetSession::SetCookie

Parameterwaarden

Retourwaarde

Opmerkingen

CInternetSession::SetOption

Parameterwaarden

Retourwaarde

Zie ook

Feedback

Aanvullende resources

`CInternetSession`-klasse

`CInternetSession::CInternetSession`

`CInternetSession::Close`

`CInternetSession::EnableStatusCallback`

`CInternetSession::GetContext`

`CInternetSession::GetCookie`

`CInternetSession::GetCookieLength`

`CInternetSession::GetFtpConnection`

`CInternetSession::GetGopherConnection`

`CInternetSession::GetHttpConnection`

`CInternetSession::OnStatusCallback`

`CInternetSession::OpenURL`

`CInternetSession::operator HINTERNET`

`CInternetSession::SetCookie`

`CInternetSession::SetOption`