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

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

  • Статья

[Функция 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, которая содержит имя узла, или десятичный IP-адрес с точками (например, 198.105.232.1).

[in] nServerPort

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

[in] lpszDisplayString

Указатель на строку, завершающуюся значением NULL, которая содержит отображаемый документ или каталог 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 или InternetGetLastResponseInfo.

Комментарии

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

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

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

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

Примечание

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

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

Функции WinINet