Export (0) Print
Expand All
TRY
Expand Minimize

AfxParseURL

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

Show:
© 2014 Microsoft