Функция GopherCreateLocatorA (wininet.h)

Статья
11/20/2024

[Функция GopherCreateLocator доступна для использования в операционных системах, указанных в разделе "Требования".

Создает строку указателя Gopher или Gopher+ из компонентов строки селектора.

Синтаксис

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

Параметры

[in] lpszHost

Указатель на строку null-terminated, содержащую имя узла, или десятичный IP-адрес (например, 198.105.232.1).

[in] nServerPort

Номер порта, на котором сервер Gopher в lpszHost живет в порядке байтов узла. Если nServerPortINTERNET_INVALID_PORT_NUMBER, используется порт gopher по умолчанию.

[in] lpszDisplayString

Указатель на строку null-terminated, содержащую документ gopher или каталог для отображения. Если этот параметр NULL, функция возвращает каталог по умолчанию для сервера Gopher.

[in] lpszSelectorString

Указатель на строку селектора для отправки на сервер Gopher для получения информации. Этот параметр может быть NULL.

[in] dwGopherType

Определяет, относится ли lpszSelectorString к каталогу или документу, а также указывает, является ли запрос gopher+ или Gopher. Значение по умолчанию, GOPHER_TYPE_DIRECTORY, используется, если значение dwGopherType равно нулю. Это может быть одно из значений типа gopher .

[out] lpszLocator

Указатель на буфер, получающий строку указателя. Если lpszLocator имеет значение NULL , lpdwBufferLength получает необходимую длину буфера, но функция не выполняет другую обработку.

[in, out] lpdwBufferLength

Указатель на переменную, содержащую длину буфера lpszLocator в символах. Когда функция возвращается, этот параметр получает количество символов, записанных в буфер. Если GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, этот параметр получает необходимое количество символов.

Возвращаемое значение

Возвращает TRUE, если выполнено успешно или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError или InternetGetLastLastResponseInfo.

Замечания

Чтобы получить сведения с сервера Gopher, приложение должно сначала получить locator gopher с сервера Gopher.

Указатель, который приложение должно рассматривать как непрозрачный маркер, обычно используется для вызовов функции gopherFindFirstFile для получения определенной части информации.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

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

Заметка

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

Требования

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

См. также

Функции WinINet

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