estructura URL_COMPONENTSA (wininet.h)

Contiene las partes constituyentes de una dirección URL. Esta estructura se usa con las funciones de InternetCrackUrl y InternetCreateUrl.

Sintaxis

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;

Miembros

dwStructSize

Tamaño de esta estructura, en bytes.

lpszScheme

Puntero a una cadena que contiene el nombre del esquema.

dwSchemeLength

Tamaño del nombre del esquema, en TCHAR.

nScheme

INTERNET_SCHEME valor que indica el esquema de protocolo de Internet.

lpszHostName

Puntero a una cadena que contiene el nombre de host.

dwHostNameLength

Tamaño del nombre de host, en TCHAR.

nPort

Número de puerto convertido.

lpszUserName

Puntero a un valor de cadena que contiene el nombre de usuario.

dwUserNameLength

Tamaño del nombre de usuario, en TCHAR.

lpszPassword

Puntero a una cadena que contiene la contraseña.

dwPasswordLength

Tamaño de la contraseña, en TCHAR.

lpszUrlPath

Puntero a una cadena que contiene la ruta de acceso de dirección URL.

dwUrlPathLength

Tamaño de la ruta de acceso url, en TCHAR.

lpszExtraInfo

Puntero a una cadena que contiene la información adicional (por ejemplo, ?algo o #something).

dwExtraInfoLength

Tamaño de la información adicional, en TCHAR.

Observaciones

Para InternetCrackUrl, si un miembro de puntero y su miembro de longitud correspondiente son cero, ese componente no se devuelve. 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. El componente puede ser sin escape, dependiendo del parámetro dwFlags de InternetCrackUrl.

Para InternetCreateUrl, los miembros del puntero deben ser NULL si el componente no es necesario. Si el miembro de longitud correspondiente es cero, el miembro de puntero es la dirección de una cadena terminada en cero. Si el miembro de longitud no es cero, es la longitud de cadena del miembro de puntero correspondiente.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).

 

Nota

El encabezado wininet.h define URL_COMPONENTS como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	wininet.h

Consulte también

InternetCrackUrl

InternetCreateUrl