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

Статья
11/20/2024

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

Синтаксис

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

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

nScheme

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

lpszHostName

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

dwHostNameLength

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

nPort

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

lpszUserName

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

dwUserNameLength

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

lpszPassword

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

dwPasswordLength

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

lpszUrlPath

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

dwUrlPathLength

Размер пути URL-адреса в TCHARs.

lpszExtraInfo

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

dwExtraInfoLength

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

Замечания

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	wininet.h

См. также

InternetCrackUrl

InternetCreateUrl

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