Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

AfxParseURL

 

This global is used in CInternetSession::OpenURL.


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

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.

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

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

System_CAPS_noteNote

To call this function, your project must include AFXINET.H.

Requirements

Header: afxinet.h

Show: