AfxParseURL

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

Return Value

Nonzero if the URL was successfully parsed; otherwise, 0 if it is empty or does not contain a known Internet service type.

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.

Remarks

This global is used in CInternetSession::OpenURL. 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   In order to call this function, your project must include AFXINET.H.

See Also   AfxGetInternetHandleType,