AfxParseURLEx

BOOL AFXAPI AfxParseURLEx (LPCTSTR pstrURLDWORDamp ;dwServiceType, CString &strServer, CString &%{strObject/, INTERNET_PORT &nPort, CString &strUsername, CString &strPasswordDWORDdwFlags = 0 );

Valeur de retour

Différent de zéro si l'URL a été analysée avec succès ; sinon, 0 si elle est vide ou ne contient pas un type connu du service Internet.

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 suivant le type de service.

%{strObject/

L'URL fait référence à un objet (peut être vide).

nPort

Déterminé à partir des parties soit le serveur ou l'objet de l'URL, si soit il existe.

strUsername

Une référence à un objet CString contenant le nom de l'utilisateur.

strPassword

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

dwFlags

Les indicateurs contrôlant comment analyser l'URL. Peut être une combinaison des valeurs suivantes:

Valeur	Sens
ICU_DECODE	Convertir des séquences d'échappement XX % de personnages.
ICU_NO_ENCODE	Ne pas convertir les caractères dangereuses pour échapper à la séquence.
ICU_NO_META	Ne supprimez pas de séquences de meta (comme « \. » et « \ »..) de l'URL.
ICU_ENCODE_SPACES_ONLY	Coder des espaces uniquement.
ICU_BROWSER_MODE	Ne pas coder ou décoder les caractères après le « # » ou '?' et ne supprimez pas l'espace blanc fin après '?'. Si cette valeur n'est pas spécifiée, l'URL complète est codé et fin l'espace blanc est retiré.

Si vous utilisez la valeur par défaut MFC, qui n'est pas d'indicateurs, la fonction convertit tous les caractères non sécuritaires et séquences de meta (tel que \., \.., et \...) pour échapper à des séquences.

Remarques

Cette fonction globale est la version étendue de AfxParseURL et est utilisée dans CInternetSession::OpenURL. Il analyse une chaîne URL et retourne le type de service et ses composantes, ainsi que des nom et mot de passe de l'utilisateur. Les drapeaux indiquent comment dangereuses personnages sont traitées.

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

Voir aussi ;AfxGetInternetHandleType

Index