Internet-URL-Analyse von Globalen und Hilfsprogramme

Wenn ein Client eine Abfrage an den Internetserver sendet, können Sie eine der URL-Analyse-Globalen verwenden, um Informationen über den Client zu extrahieren. Die Hilfsfunktionen bieten weitere Internetfunktionen.

Globale Variablen zur Analyse von Internet-URLs

Weitere Internethilfsprogramme

AfxParseURL

Diese globale Wird in CInternetSession::OpenURL verwendet.

BOOL AFXAPI AfxParseURL(
    LPCTSTR pstrURL,
    DWORD& dwServiceType,
    CString& strServer,
    CString& strObject,
    INTERNET_PORT& nPort);

Parameter

pstrURL
Ein Zeiger auf eine Zeichenfolge, die die zu analysierende URL enthält.

dwServiceType
Gibt den Typ des Internetdiensts an. Verfügbare mögliche Werte:

• AFX_INET_SERVICE_FTP

• AFX_INET_SERVICE_HTTP

• AFX_INET_SERVICE_HTTPS

• AFX_INET_SERVICE_GOPHER

• AFX_INET_SERVICE_FILE

• AFX_INET_SERVICE_MAILTO

• AFX_INET_SERVICE_NEWS

• AFX_INET_SERVICE_NNTP

• AFX_INET_SERVICE_TELNET

• AFX_INET_SERVICE_WAIS

• AFX_INET_SERVICE_MID

• AFX_INET_SERVICE_CID

• AFX_INET_SERVICE_PROSPERO

• AFX_INET_SERVICE_AFS

• AFX_INET_SERVICE_UNK

strServer
Das erste Segment der URL nach dem Diensttyp.

strObject
Ein Objekt, auf das sich die URL bezieht (kann leer sein).

nPort
Bestimmt von den Server- oder Objektabschnitten der URL, falls vorhanden.

Rückgabewert

Nonzero, wenn die URL erfolgreich analysiert wurde; andernfalls 0, wenn sie leer ist oder keinen bekannten Internetdiensttyp enthält.

Hinweise

Sie analysiert eine URL-Zeichenfolge und gibt den Diensttyp und die zugehörigen Komponenten zurück.

Analysiert z AfxParseURL . B. URLs des Formulars service://server/dir/dir/object.ext:port und gibt seine Komponenten wie folgt zurück:

strServer == "server"

strObject == "/dir/dir/object/object.ext"

nPort == #port

dwServiceType == #service

Anforderungen

Header afxinet.h

AfxParseURLEx

Diese globale Funktion ist die erweiterte Version von AfxParseURL und wird in CInternetSession::OpenURL verwendet.

BOOL AFXAPI AfxParseURLEx(
    LPCTSTR pstrURL,
    DWORD& dwServiceType,
    CString& strServer,
    CString& strObject,
    INTERNET_PORT& nPort,
    CString& strUsername,
    CString& strPassword,
    DWORD dwFlags = 0);

Parameter

pstrURL
Ein Zeiger auf eine Zeichenfolge, die die zu analysierende URL enthält.

dwServiceType
Gibt den Typ des Internetdiensts an. Verfügbare mögliche Werte:

• AFX_INET_SERVICE_FTP

• AFX_INET_SERVICE_HTTP

• AFX_INET_SERVICE_HTTPS

• AFX_INET_SERVICE_GOPHER

• AFX_INET_SERVICE_FILE

• AFX_INET_SERVICE_MAILTO

• AFX_INET_SERVICE_NEWS

• AFX_INET_SERVICE_NNTP

• AFX_INET_SERVICE_TELNET

• AFX_INET_SERVICE_WAIS

• AFX_INET_SERVICE_MID

• AFX_INET_SERVICE_CID

• AFX_INET_SERVICE_PROSPERO

• AFX_INET_SERVICE_AFS

• AFX_INET_SERVICE_UNK

strServer
Das erste Segment der URL nach dem Diensttyp.

strObject
Ein Objekt, auf das sich die URL bezieht (kann leer sein).

nPort
Bestimmt von den Server- oder Objektabschnitten der URL, falls vorhanden.

strUsername
Ein Verweis auf ein CString Objekt, das den Namen des Benutzers enthält.

strPassword
Ein Verweis auf ein CString Objekt, das das Kennwort des Benutzers enthält.

dwFlags
Die Flags, die steuern, wie die URL analysiert wird. Dies kann eine Kombination der folgenden Werte sein:

Wenn Sie den MFC-Standardwert verwenden, bei dem es sich nicht um Flags handelt, konvertiert die Funktion alle unsicheren Zeichen und Metasequenzen (z. B. \.,\ .., und \...) in Escapesequenzen.

Rückgabewert

Nonzero, wenn die URL erfolgreich analysiert wurde; andernfalls 0, wenn sie leer ist oder keinen bekannten Internetdiensttyp enthält.

Hinweise

Sie analysiert eine URL-Zeichenfolge und gibt den Diensttyp und die zugehörigen Komponenten sowie den Namen und das Kennwort des Benutzers zurück. Die Flags geben an, wie unsichere Zeichen behandelt werden.

Anforderungen

Header afxinet.h

AfxGetInternetHandleType

Verwenden Sie diese globale Funktion, um den Typ eines Internethandle zu bestimmen.

Syntax

DWORD AFXAPI AfxGetInternetHandleType(  HINTERNET hQuery );

Parameter

hQuery
Ein Handle für eine Internetabfrage.

Rückgabewert

Jeder der Internetdiensttypen, die von WININET.H definiert sind. Eine Liste dieser Internetdienste finden Sie im Abschnitt "Hinweise". Wenn der Handle NULL ist oder nicht erkannt wird, gibt die Funktion AFX_INET_SERVICE_UNK zurück.

Hinweise

Die folgende Liste enthält mögliche Internettypen, die von AfxGetInternetHandleType.

• INTERNET_HANDLE_TYPE_INTERNET

• INTERNET_HANDLE_TYPE_CONNECT_FTP

• INTERNET_HANDLE_TYPE_CONNECT_GOPHER

• INTERNET_HANDLE_TYPE_CONNECT_HTTP

• INTERNET_HANDLE_TYPE_FTP_FIND

• INTERNET_HANDLE_TYPE_FTP_FIND_HTML

• INTERNET_HANDLE_TYPE_FTP_FILE

• INTERNET_HANDLE_TYPE_FTP_FILE_HTML

• INTERNET_HANDLE_TYPE_GOPHER_FIND

• INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

• INTERNET_HANDLE_TYPE_GOPHER_FILE

• INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

• INTERNET_HANDLE_TYPE_HTTP_REQUEST

Anforderungen

Kopfzeile: afxinet.h

AfxThrowInternetException

Löst eine Internet-Ausnahme aus.

Syntax

   void AFXAPI AfxThrowInternetException(  DWORD dwContext,  DWORD dwError = 0 );

Parameter

dwContext
Der Kontextbezeichner für den Vorgang, der den Fehler verursacht hat. Der Standardwert von dwContext wird ursprünglich in CInternetSession angegeben und an von CInternetConnection- und CInternetFile abgeleitete Klassen übergeben. Für bestimmte Vorgänge, die für eine Verbindung oder datei ausgeführt werden, überschreiben Sie in der Regel den Standardwert mit einem dwContext ihres eigenen. Dieser Wert wird dann an CInternetSession::OnStatusCallback zurückgegeben, um den Status des bestimmten Vorgangs zu identifizieren.

dwError
Der Fehler, der die Ausnahme verursacht hat.

Hinweise

Sie sind für die Ermittlung der Ursache auf der Grundlage des Betriebssystemfehlercodes verantwortlich.

Anforderungen

Kopfzeile: afxinet.h

Siehe auch

Makros und Globalen
CInternetException-Klasse
AfxParseURL