Partilhar via


AfxParseURLEx

Essa função global é a versão estendida de AfxParseURL e é usada 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 cadeia de caracteres que contém a URL a ser analisado.

  • dwServiceType
    Indica o tipo de serviço da web. Os valores possíveis são os seguintes:

    • 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 de URL depois do tipo de serviço.

  • strObject
    Um objeto que faz referência à URL (pode estar vazia).

  • nPort
    Determinado as partes do servidor ou do objeto de URL, ou se ela existe.

  • strUsername
    Uma referência a um objeto de CString que contém o nome do usuário.

  • strPassword
    Uma referência a um objeto de CString que contém a senha do usuário.

  • dwFlags
    Os sinalizadores que controlam como analisar a URL. Pode ser uma combinação dos seguintes valores:

    Valor

    Significado

    ICU_DECODE

    Sequências de escape de conversão %XX para caracteres.

    ICU_NO_ENCODE

    Não converter caracteres não seguro para a sequência de escape.

    ICU_NO_META

    Não remova as sequências de meta (como "\ ." e "\ ..") da URL.

    ICU_ENCODE_SPACES_ONLY

    Codificar os espaços somente.

    ICU_BROWSER_MODE

    Não afeta nem decodificam caracteres depois de “#” ou “? ”, e não remova o espaço em branco à direita após “?”. Se esse valor não for especificado, a URL inteira é codificado e o espaço em branco à direita são removidos.

    Se você usar a opção de MFC, que não tem nenhum sinalizador, todos da função converte caracteres não seguro e meta gerador de sequência (como \. , \. , e \…) as sequências de escape.

Valor de retorno

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

Comentários

Analisa uma cadeia de caracteres de URL e retorna o tipo de serviço e de seus componentes, além de fornecer o nome e a senha do usuário. Os sinalizadores indicam como os caracteres não seguro são tratados.

Dica

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

Requisitos

Header: afxinet.h

Consulte também

Referência

AfxGetInternetHandleType

Conceitos

Macros e globais MFC