estrutura URL_COMPONENTS (winhttp.h)
A estrutura URL_COMPONENTS contém as partes constituintes de uma URL. Essa estrutura é usada com as funções WinHttpCrackUrl e WinHttpCreateUrl .
Sintaxe
typedef struct _WINHTTP_URL_COMPONENTS {
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_COMPONENTS, *LPURL_COMPONENTS;
Membros
dwStructSize
Tamanho dessa estrutura, em bytes. Usado para verificação de versão. O tamanho dessa estrutura deve ser definido para inicializar essa estrutura corretamente.
lpszScheme
Ponteiro para um valor de cadeia de caracteres que contém o nome do esquema.
dwSchemeLength
Comprimento do nome do esquema, em caracteres.
nScheme
Esquema de protocolo de Internet. Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
|
O esquema da Internet é o protocolo HTTP. Consulte RFC 2616 para obter mais informações. |
|
O esquema de Internet, HTTPS, é um protocolo HTTP que usa semântica de transação segura. |
lpszHostName
Ponteiro para um valor de cadeia de caracteres que contém o nome do host.
dwHostNameLength
Comprimento do nome do host, em caracteres.
nPort
Número da porta.
lpszUserName
Ponteiro para uma cadeia de caracteres que contém o nome de usuário.
dwUserNameLength
Comprimento do nome de usuário, em caracteres.
lpszPassword
Ponteiro para uma cadeia de caracteres que contém a senha.
dwPasswordLength
Comprimento da senha, em caracteres.
lpszUrlPath
Ponteiro para uma cadeia de caracteres que contém o caminho da URL.
dwUrlPathLength
Comprimento do caminho da URL, em caracteres.
lpszExtraInfo
Ponteiro para um valor de cadeia de caracteres que contém as informações extras, por exemplo, ?something ou #something.
dwExtraInfoLength
Valor inteiro longo sem sinal que contém o comprimento das informações extras, em caracteres.
Comentários
Para a função WinHttpCrackUrl , se um membro de ponteiro e seu membro de comprimento correspondente forem zero, esse componente da URL 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. Todas as sequências de escape podem ser removidas de um componente, dependendo do parâmetro dwFlags de WinHttpCrackUrl.
Para a função WinHttpCreateUrl , os membros do ponteiro deverão ser NULL se o componente da URL não for necessário. Se o membro de comprimento correspondente for zero, o membro do ponteiro será o ponteiro para 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.
Requisitos
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho] |
| Cabeçalho | winhttp.h |
| Redistribuível | WinHTTP 5.0 e Internet Explorer 5.01 ou posterior no Windows XP e Windows 2000. |