AfxParseURLEx

Artigo
02/25/2013

Esta função global é a versão estendida do AfxParseURL e é usado em CInternetSession::OpenURL.

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

Parâmetros

pstrURL
Um ponteiro para uma seqüência de caracteres contendo a URL a ser analisado.
dwServiceType
Indica o tipo de serviço de Internet.Valores possíveis são:
- 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
O primeiro segmento da URL após o tipo de serviço.
strObject
Um objeto que se refere a URL (pode ser vazio).
nPort
Determinada a partir do servidor ou o objeto partes da URL, se existir um.
strUsername
Uma referência a um CString objeto que contém o nome do usuário.
strPassword
Uma referência a um CString objeto que contém a senha do usuário.

dwFlags
Os sinalizadores de controle como analisar o URL.Pode ser uma combinação dos seguintes valores:

Valor	Significado
ICU_DECODE	Converta seqüências de escape XX % caracteres.
ICU_NO_ENCODE	Não converta caracteres não seguros para a seqüência de escape.
ICU_NO_META	Não remova seqüências de meta (como, por exemplo, "\" e "\"...) da URL.
ICU_ENCODE_SPACES_ONLY	Codifica somente espaços.
ICU_BROWSER_MODE	Não codificar ou decodificar caracteres após '#' ou '?' e não remova o espaço em branco à direita após '?'.Se esse valor não for especificado, a URL inteira é codificada e espaço em branco à direita é removido.

Se você usar o padrão do MFC, que é sem sinalizadores, a função converte todos os caracteres inseguros e seqüências de meta (como \., \.., e \...) para escape sequences.

Valor de retorno

Diferente de zero se a URL foi analisada com êxito; Caso contrário, 0 se ele estiver vazio ou não contém um tipo de serviço de Internet conhecido.

Comentários

Ele analisa uma seqüência de caracteres de URL e retorna o tipo de serviço e seus componentes, bem como fornecer o nome de usuário e senha.Os sinalizadores indicam caracteres como inseguros são manipulados.

Observação
Para chamar esta função, seu projeto deve incluir AFXINET.H.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

AfxGetInternetHandleType

Conceitos

Globais e Macros do MFC

Compartilhar via