estructura de URL_COMPONENTS (winhttp.h)
La estructura URL_COMPONENTS contiene las partes constituyentes de una dirección URL. Esta estructura se usa con las funciones WinHttpCrackUrl y WinHttpCreateUrl .
Sintaxis
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;
Miembros
dwStructSize
Tamaño de esta estructura, en bytes. Se usa para la comprobación de versiones. El tamaño de esta estructura debe establecerse para inicializar esta estructura correctamente.
lpszScheme
Puntero a un valor de cadena que contiene el nombre del esquema.
dwSchemeLength
Longitud del nombre del esquema, en caracteres.
nScheme
Esquema de protocolo de Internet. Este miembro puede ser uno de los valores siguientes.
| Value | Significado |
|---|---|
|
El esquema de Internet es el protocolo HTTP. Consulte RFC 2616 para obtener más información. |
|
El esquema de Internet, HTTPS, es un protocolo HTTP que usa semántica de transacciones seguras. |
lpszHostName
Puntero a un valor de cadena que contiene el nombre de host.
dwHostNameLength
Longitud del nombre de host, en caracteres.
nPort
Número de puerto.
lpszUserName
Puntero a una cadena que contiene el nombre de usuario.
dwUserNameLength
Longitud del nombre de usuario, en caracteres.
lpszPassword
Puntero a una cadena que contiene la contraseña.
dwPasswordLength
Longitud de la contraseña, en caracteres.
lpszUrlPath
Puntero a una cadena que contiene la ruta de acceso url.
dwUrlPathLength
Longitud de la ruta de acceso url, en caracteres.
lpszExtraInfo
Puntero a un valor de cadena que contiene la información adicional, por ejemplo, ?algo o #something.
dwExtraInfoLength
Valor entero largo sin signo que contiene la longitud de la información adicional, en caracteres.
Comentarios
Para la función WinHttpCrackUrl , si un miembro de puntero y su miembro de longitud correspondiente son cero, no se devuelve ese componente de la dirección URL. Si el miembro de puntero es NULL , pero el miembro length no es cero, se devuelven los miembros de puntero y longitud. Si tanto el puntero como los miembros de longitud correspondientes son distintos de cero, el miembro de puntero apunta a un búfer donde se copia el componente. Todas las secuencias de escape se pueden quitar de un componente, según el parámetro dwFlags de WinHttpCrackUrl.
Para la función WinHttpCreateUrl , los miembros del puntero deben ser NULL si el componente de la dirección URL no es necesario. Si el miembro de longitud correspondiente es cero, el miembro de puntero es el puntero a una cadena terminada en cero. Si el miembro length no es cero, es la longitud de cadena del miembro de puntero correspondiente.
Requisitos
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio] |
| Encabezado | winhttp.h |
| Redistribuible | WinHTTP 5.0 e Internet Explorer 5.01 o posterior en Windows XP y Windows 2000. |