AfxParseURL
Visual Studio .NET 2003
This global is used in CInternetSession::OpenURL.
BOOL AFXAPI AfxParseURL( LPCTSTR pstrURL, DWORD& dwServiceType, CString& strServer, CString& strObject, INTERNET_PORT& nPort );
Parameters
- pstrURL
- A pointer to a string containing the URL to be parsed.
- dwServiceType
- Indicates the type of Internet service. Possible values are as follows:
- 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
- The first segment of the URL following the service type.
- strObject
- An object that the URL refers to (may be empty).
- nPort
- Determined from either the Server or Object portions of the URL, if either exists.
Return Value
Nonzero if the URL was successfully parsed; otherwise, 0 if it is empty or does not contain a known Internet service type.
Remarks
It parses a URL string and returns the type of service and its components.
For example, AfxParseURL parses URLs of the form service://server/dir/dir/object.ext:port and returns its components stored as follows:
strServer == "server"
strObject == "/dir/dir/object/object.ext"
nPort == #port
dwServiceType == #service
Note To call this function, your project must include AFXINET.H.
See Also
MFC Macros and Globals | AfxGetInternetHandleType | AfxParseURLEx
