Поделиться через

структура URL_COMPONENTS (winhttp.h)

  • Статья

Структура URL_COMPONENTS содержит составные части URL-адреса. Эта структура используется с функциями WinHttpCrackUrl и WinHttpCreateUrl .

Синтаксис

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;

Члены

dwStructSize

Размер этой структуры в байтах. Используется для проверки версии. Чтобы правильно инициализировать эту структуру, необходимо задать размер этой структуры.

lpszScheme

Указатель на строковое значение, содержащее имя схемы.

dwSchemeLength

Длина имени схемы в символах.

nScheme

Схема интернет-протокола. Этот элемент может быть одним из следующих значений.

Значение Значение
INTERNET_SCHEME_HTTP
1
 Схема Интернета — это протокол HTTP. Дополнительные сведения см. в статье RFC 2616 .
INTERNET_SCHEME_HTTPS
2
 Схема Интернета HTTPS — это протокол HTTP, использующий безопасную семантику транзакций.

lpszHostName

Указатель на строковое значение, содержащее имя узла.

dwHostNameLength

Длина имени узла в символах.

nPort

Номер порта.

lpszUserName

Указатель на строку, содержащую имя пользователя.

dwUserNameLength

Длина имени пользователя в символах.

lpszPassword

Указатель на строку, содержащую пароль.

dwPasswordLength

Длина пароля в символах.

lpszUrlPath

Указатель на строку, содержащую URL-путь.

dwUrlPathLength

Длина URL-пути в символах.

lpszExtraInfo

Указатель на строковое значение, содержащее дополнительные сведения, например что-то или #something.

dwExtraInfoLength

Длинное целочисленное значение без знака, содержащее длину дополнительных сведений в символах.

Комментарии

Для функции WinHttpCrackUrl , если элемент указателя и соответствующий ему элемент длины равны нулю, этот компонент URL-адреса не возвращается. Если элемент указателя имеет значение NULL , но член длины не равен нулю, возвращаются как элементы указателя, так и элементы длины. Если и указатель, и соответствующие члены длины не являются нулевой, элемент указателя указывает на буфер, в который копируется компонент. Все escape-последовательности можно удалить из компонента в зависимости от параметра dwFlagswinHttpCrackUrl.

Для функции WinHttpCreateUrl элементы указателя должны иметь значение NULL , если компонент URL-адреса не требуется. Если соответствующий элемент длины равен нулю, то элемент указателя является указателем на строку с нулевым завершением. Если элемент длины не равен нулю, это строка длины соответствующего элемента указателя.

Примечание Для Windows XP и Windows 2000 см. раздел Требования во время выполнения начальной страницы WinHttp.
 

Требования

   
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Верхняя часть winhttp.h
Распространяемые компоненты WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000.

См. также раздел

Версии WinHTTP