estrutura URL_COMPONENTSA (wininet.h)

Artigo
11/20/2024

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

Sintaxe

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

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 de 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.

Observações

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 não forem zero, o membro do ponteiro apontará para um buffer em que o componente é copiado. O componente pode ser não escapado, dependendo do parâmetro dwFlags de InternetCrackUrl.

Para InternetCreateUrl, os membros do ponteiro devem 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.

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

InternetCrackUrl

InternetCreateUrl

Compartilhar via