estrutura URL_COMPONENTSW (wininet.h)

  • Artigo

Contém as partes constituintes de uma URL. Essa estrutura é usada com as funções InternetCrackUrl e InternetCreateUrl .

Sintaxe

typedef struct {
  DWORD           dwStructSize;
  LPWSTR          lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPWSTR          lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPWSTR          lpszUserName;
  DWORD           dwUserNameLength;
  LPWSTR          lpszPassword;
  DWORD           dwPasswordLength;
  LPWSTR          lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPWSTR          lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTSW, *LPURL_COMPONENTSW;

Membros

dwStructSize

Tamanho dessa estrutura, em bytes.

lpszScheme

Ponteiro para uma cadeia de caracteres que contém o nome do esquema.

dwSchemeLength

Tamanho do nome do esquema, em TCHARs.

nScheme

INTERNET_SCHEME valor que indica o esquema de protocolo da Internet.

lpszHostName

Ponteiro para uma cadeia de caracteres que contém o nome do host.

dwHostNameLength

Tamanho do nome do host, em TCHARs.

nPort

Número da porta convertida.

lpszUserName

Ponteiro para um valor de cadeia de caracteres que contém o nome de usuário.

dwUserNameLength

Tamanho do nome de usuário, em TCHARs.

lpszPassword

Ponteiro para uma cadeia de caracteres que contém a senha.

dwPasswordLength

Tamanho da senha, em TCHARs.

lpszUrlPath

Ponteiro para uma cadeia de caracteres que contém o caminho da URL.

dwUrlPathLength

Tamanho do caminho da URL, em TCHARs.

lpszExtraInfo

Ponteiro para uma cadeia de caracteres que contém as informações extras (por exemplo, ?algo ou #something).

dwExtraInfoLength

Tamanho das informações extras, em TCHARs.

Comentários

Para InternetCrackUrl, se um membro de ponteiro e seu membro de comprimento correspondente forem zero, esse componente não será retornado. Se o membro do ponteiro for NULL , mas o membro de comprimento não for zero, os membros de ponteiro e comprimento serão retornados. Se os membros de ponteiro e de comprimento correspondente forem diferentes de zero, o membro do ponteiro apontará para um buffer em que o componente é copiado. O componente pode não ser escapado, dependendo do parâmetro dwFlags de InternetCrackUrl.

Para InternetCreateUrl, os membros do ponteiro deverão ser NULL se o componente não for necessário. Se o membro de comprimento correspondente for zero, o membro do ponteiro será o endereço de uma cadeia de caracteres terminada em zero. Se o membro de comprimento não for zero, será o comprimento da cadeia de caracteres do membro do ponteiro correspondente.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define URL_COMPONENTS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho wininet.h

Confira também

InternetCrackUrl

InternetCreateUrl