Export (0) Print
Expand All
TRY
Expand Minimize

AfxParseURLEx

This global function is the extended version of AfxParseURL and is used in CInternetSession::OpenURL.

BOOL AFXAPI AfxParseURLEx( 
   LPCTSTR pstrURL, 
   DWORD& dwServiceType, 
   CString& strServer, 
   CString& strObject, 
   INTERNET_PORT& nPort, 
   CString& strUsername, 
   CString& strPassword, 
   DWORD dwFlags = 0  
);

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.

strUsername

A reference to a CString object containing the name of the user.

strPassword

A reference to a CString object containing the password of the user.

dwFlags

The flags controlling how to parse the URL. Can be a combination of the following values:

Value

Meaning

ICU_DECODE

Convert %XX escape sequences to characters.

ICU_NO_ENCODE

Do not convert unsafe characters to escape sequence.

ICU_NO_META

Do not remove meta sequences (such as "\ ." and "\ ..") from the URL.

ICU_ENCODE_SPACES_ONLY

Encode spaces only.

ICU_BROWSER_MODE

Do not encode or decode characters after '#' or '?', and do not remove trailing white space after '?'. If this value is not specified, the entire URL is encoded and trailing white space is removed.

If you use the MFC default, which is no flags, the function converts all unsafe characters and meta sequences (such as \.,\ .., and \...) to escape sequences.

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, as well as providing the user's name and password. The flags indicate how unsafe characters are handled.

Note Note

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

Header: afxinet.h

Community Additions

ADD
Show:
© 2014 Microsoft