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
| Name | Beschreibung |
|---|---|
| AfxParseURL | Analysiert eine URL-Zeichenfolge und gibt den Diensttyp und die zugehörigen Komponenten zurück. |
| AfxParseURLEx | Analysiert eine URL-Zeichenfolge und gibt den Diensttyp und die zugehörigen Komponenten sowie den Benutzernamen und das Kennwort zurück. |
Weitere Internethilfsprogramme
| Name | Beschreibung |
|---|---|
| AfxThrowInternetException | Löst eine Ausnahme im Zusammenhang mit der Internetverbindung aus. |
| AfxGetInternetHandleType | Bestimmt den Typ eines Internethandle. |
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
Hinweis
Um diese Funktion aufzurufen, muss Ihr Projekt AFXINET.H enthalten.
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:
| Wert | Bedeutung |
|---|---|
| ICU_DECODE | Konvertieren von %XX Escapesequenzen in Zeichen. |
| ICU_NO_ENCODE | Konvertieren Sie unsichere Zeichen nicht in Escapesequenz. |
| ICU_NO_META | Entfernen Sie keine Metasequenzen (z. B. "\" und "\ ..") aus der URL. |
| ICU_ENCODE_SPACES_ONLY | Nur Leerzeichen codieren. |
| ICU_BROWSER_MODE | Codieren oder decodieren Sie keine Zeichen nach '#' oder '', und entfernen Sie nach '' keine nachfolgenden Leerzeichen. Wenn dieser Wert nicht angegeben ist, wird die gesamte URL codiert und nachfolgende Leerzeichen entfernt. |
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.
Hinweis
Um diese Funktion aufzurufen, muss Ihr Projekt AFXINET.H enthalten.
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
Hinweis
Um diese Funktion aufzurufen, muss Ihr Projekt AFXINET.H enthalten.
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.
Hinweis
Um diese Funktion aufzurufen, muss Ihr Projekt AFXINET.H enthalten.
Anforderungen
Kopfzeile: afxinet.h