структура URL_COMPONENTSA (wininet.h)

  • Статья

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

Синтаксис

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;

Члены

dwStructSize

Размер этой структуры в байтах.

lpszScheme

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

dwSchemeLength

Размер имени схемы в TCHAR.

nScheme

INTERNET_SCHEME значение, указывающее схему протокола Интернета.

lpszHostName

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

dwHostNameLength

Размер имени узла в TCHAR.

nPort

Преобразованный номер порта.

lpszUserName

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

dwUserNameLength

Размер имени пользователя в TCHAR.

lpszPassword

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

dwPasswordLength

Размер пароля в TCHAR.

lpszUrlPath

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

dwUrlPathLength

Размер URL-пути в TCHAR.

lpszExtraInfo

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

dwExtraInfoLength

Размер дополнительных сведений в TCHAR.

Комментарии

Для InternetCrackUrl, если элемент указателя и соответствующий ему элемент длины равны нулю, этот компонент не возвращается. Если элемент указателя имеет значение NULL , а член длины не равен нулю, возвращаются как элементы указателя, так и длины. Если оба элемента указателя и соответствующие элементы длины не являются нулевой, элемент указателя указывает на буфер, в который копируется компонент. Компонент можно отменить экранирование в зависимости от параметра dwFlagsinternetCrackUrl.

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

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Примечание

Заголовок wininet.h определяет URL_COMPONENTS в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть wininet.h

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

InternetCrackUrl

InternetCreateUrl