AfxParseURL

 

This global is used in CInternetSession::OpenURL.

Syntax

      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.

Requirements

Header: afxinet.h

See Also

MFC Macros and Globals
AfxGetInternetHandleType
AfxParseURLEx