Genel ve Yardımcıları Ayrıştırma İnternet URL'si
İstemci İnternet sunucusuna bir sorgu gönderdiğinde, istemci hakkındaki bilgileri ayıklamak için URL ayrıştırma genel değerlerinden birini kullanabilirsiniz. Yardımcı işlevler diğer internet işlevlerini sağlar.
Internet URL Ayrıştırma Genel Öğeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| AfxParseURL | URL dizesini ayrıştırarak hizmet türünü ve bileşenlerini döndürür. |
| AfxParseURLEx | BIR URL dizesini ayrıştırarak hizmet türünü ve bileşenlerini döndürür, ayrıca kullanıcı adı ve parola sağlar. |
Diğer İnternet Yardımcıları
| Veri Akışı Adı | Açıklama |
|---|---|
| AfxThrowInternetException | İnternet bağlantısıyla ilgili bir özel durum oluşturur. |
| AfxGetInternetHandleType | İnternet tanıtıcısının türünü belirler. |
AfxParseURL
Bu genel, CInternetSession::OpenURL içinde kullanılır.
BOOL AFXAPI AfxParseURL(
LPCTSTR pstrURL,
DWORD& dwServiceType,
CString& strServer,
CString& strObject,
INTERNET_PORT& nPort);
Parametreler
pstrURL
Ayrıştırılacak URL'yi içeren bir dize işaretçisi.
dwServiceType
İnternet hizmetinin türünü gösterir. Olası değerler aşağıdaki gibidir:
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
HIZMET türünü izleyen URL'nin ilk kesimi.
strObject
URL'nin başvurduğu nesne (boş olabilir).
nPort
Varsa, URL'nin Sunucu veya Nesne bölümlerinden belirlenir.
Dönüş Değeri
URL başarıyla ayrıştırıldıysa sıfır olmayan; aksi takdirde, 0 boşsa veya bilinen bir İnternet hizmet türü içermiyorsa.
Açıklamalar
Bir URL dizesini ayrıştırarak hizmet türünü ve bileşenlerini döndürür.
Örneğin, AfxParseURL form service://server/dir/dir/object.ext:port URL'lerini ayrıştırır ve bileşenlerini aşağıdaki gibi depolar:
strServer == "sunucu"
strObject == "/dir/dir/object/object.ext"
nPort == #port
dwServiceType == #service
Not
Bu işlevi çağırmak için projenizin AFXINET.H içermesi gerekir.
Gereksinimler
Üst bilgi afxinet.h
AfxParseURLEx
Bu genel işlev, AfxParseURL'nin genişletilmiş sürümüdür ve CInternetSession::OpenURL içinde kullanılır.
BOOL AFXAPI AfxParseURLEx(
LPCTSTR pstrURL,
DWORD& dwServiceType,
CString& strServer,
CString& strObject,
INTERNET_PORT& nPort,
CString& strUsername,
CString& strPassword,
DWORD dwFlags = 0);
Parametreler
pstrURL
Ayrıştırılacak URL'yi içeren bir dize işaretçisi.
dwServiceType
İnternet hizmetinin türünü gösterir. Olası değerler aşağıdaki gibidir:
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
HIZMET türünü izleyen URL'nin ilk kesimi.
strObject
URL'nin başvurduğu nesne (boş olabilir).
nPort
Varsa, URL'nin Sunucu veya Nesne bölümlerinden belirlenir.
strUsername
Kullanıcının adını içeren bir CString nesneye başvuru.
strPassword
Kullanıcının parolasını içeren bir CString nesneye başvuru.
dwFlags
URL'nin nasıl ayrıştırılması denetlenen bayraklar. Aşağıdaki değerlerin bir bileşimi olabilir:
| Değer | Anlamı |
|---|---|
| ICU_DECODE | %XX kaçış dizilerini karakterlere dönüştürün. |
| ICU_NO_ENCODE | Güvenli olmayan karakterleri kaçış dizisine dönüştürmeyin. |
| ICU_NO_META | URL'den meta dizileri ("\ ." ve "\ .." gibi) kaldırmayın. |
| ICU_ENCODE_SPACES_ONLY | Yalnızca boşlukları kodlayın. |
| ICU_BROWSER_MODE | '#' veya '' sonrasındaki karakterleri kodlamayı veya kodunu çözmeyin ve '' sonrasındaki boşlukları kaldırmayın. Bu değer belirtilmezse, URL'nin tamamı kodlanır ve sondaki boşluk kaldırılır. |
Bayrak olmayan MFC varsayılanını kullanırsanız, işlev tüm güvenli olmayan karakterleri ve meta dizileri (\.,\ ..ve \...gibi) kaçış dizilerine dönüştürür.
Dönüş Değeri
URL başarıyla ayrıştırıldıysa sıfır olmayan; aksi takdirde, 0 boşsa veya bilinen bir İnternet hizmet türü içermiyorsa.
Açıklamalar
Bir URL dizesini ayrıştırarak hizmet türünü ve bileşenlerini döndürür, ayrıca kullanıcının adını ve parolasını sağlar. Bayraklar, güvenli olmayan karakterlerin nasıl işleneceğini gösterir.
Not
Bu işlevi çağırmak için projenizin AFXINET.H içermesi gerekir.
Gereksinimler
Üst bilgi afxinet.h
AfxGetInternetHandleType
İnternet tanıtıcısının türünü belirlemek için bu genel işlevi kullanın.
Sözdizimi
DWORD AFXAPI AfxGetInternetHandleType( HINTERNET hQuery );
Parametreler
hQuery
İnternet sorgusu tanıtıcısı.
Dönüş Değeri
WININET.H tarafından tanımlanan İnternet hizmet türlerinden herhangi biri. Bu İnternet hizmetlerinin listesi için Açıklamalar bölümüne bakın. Tanıtıcı NULL ise veya tanınmıyorsa işlev AFX_INET_SERVICE_UNK döndürür.
Açıklamalar
Aşağıdaki liste tarafından AfxGetInternetHandleTypedöndürülen olası İnternet türlerini içerir.
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
Not
Bu işlevi çağırmak için projenizin AFXINET.H içermesi gerekir.
Gereksinimler
Üst bilgi: afxinet.h
AfxThrowInternetException
İnternet özel durumu oluşturur.
Sözdizimi
void AFXAPI AfxThrowInternetException( DWORD dwContext, DWORD dwError = 0 );
Parametreler
dwContext
Hataya neden olan işlemin bağlam tanımlayıcısı. Varsayılan dwContext değeri özgün olarak CInternetSession'da belirtilir ve CInternetConnection- ve CInternetFile türetilmiş sınıflara geçirilir. Bir bağlantı veya dosya üzerinde gerçekleştirilen belirli işlemler için, varsayılanı genellikle kendi dwContext değerinizle geçersiz kılarsınız. Bu değer daha sonra belirli bir işlemin durumunu belirlemek için CInternetSession::OnStatusCallback'e döndürülür.
dwError
Özel duruma neden hata.
Açıklamalar
nedeni işletim sistemi hata koduna göre belirlemek sizin sorumluluğundadır.
Not
Bu işlevi çağırmak için projenizin AFXINET.H içermesi gerekir.
Gereksinimler
Üst bilgi: afxinet.h
Ayrıca bkz.
Makrolar ve Genel Ayarlar
CInternetException Sınıfı
AfxParseURL