AfxParseURLEx

Cette fonction globale est la version étendue d' AfxParseURL et est utilisée dans CInternetSession::OpenURL.

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

Paramètres

  • pstrURL
    Un pointeur vers une chaîne contenant l'URL à analyser.

  • dwServiceType
    Indique le type de service Internet.Les valeurs possibles sont les suivantes :

    • 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
    Le premier segment de l'URL qui suivent le type de service.

  • strObject
    Un objet à que l'URL fait référence (peut être vide).

  • nPort
    Déterminé les composants serveur ou objet de l'URL, si l'un ou l'autre existe.

  • strUsername
    Une référence à un objet d' CString contenant le nom d'utilisateur.

  • strPassword
    Une référence à un objet d' CString contenant le mot de passe de l'utilisateur.

  • dwFlags
    Les balises qui contrôle comment analyser l'URL.Peut être une combinaison des valeurs suivantes :

    Valeur

    Signification

    ICU_DECODE

    Séquences d'échappement du converti %XX aux caractères.

    ICU_NO_ENCODE

    Ne convertissez pas les caractères potentiellement dangereux à la séquence d'échappement.

    ICU_NO_META

    Ne supprimez pas les séquences de métadonnées (telles que « \." and "\.") from the URL.

    ICU_ENCODE_SPACES_ONLY

    Encodez les espaces uniquement.

    ICU_BROWSER_MODE

    N'encodent pas ou ne du décodage pas les caractères après « # » ou « ?  », et ne supprimez pas l'espace blanc de fin après « ? ».Si cette valeur n'est pas spécifiée, l'URL entier est encodé et l'espace blanc de fin est supprimé.

    Si vous utilisez la valeur par défaut de MFC, qui n'est pas de balise, tous de fonction convertit les caractères potentiellement dangereux et le métadonnées ordonnance (telle que \. , \. , et \…) en séquences d'échappement.

Valeur de retour

Une valeur différente de zéro si l'URL a été correctement analysé ; sinon, 0 s'il est vide ou ne contient pas de type de service Internet.

Notes

Il analyse une chaîne d'URL et retourne le type du service et de ses composants, ainsi que fournit le nom d'utilisateur et le mot de passe.Les balises indiquent comment les caractères potentiellement dangereux sont gérés.

[!REMARQUE]

Pour appeler cette fonction, votre projet doit inclure AFXINET.H.

Configuration requise

Header: afxinet.h

Voir aussi

Référence

AfxGetInternetHandleType

Concepts

Macro MFC et Globals