CGopherConnection::CreateLocator

Статья
06/10/2015

Эта функция-член вызывается с целью создания указатель gopher для поиска или указать файл на сервер gopher.

CGopherLocator CreateLocator( 
   LPCTSTR pstrDisplayString, 
   LPCTSTR pstrSelectorString, 
   DWORD dwGopherType  
); 
static CGopherLocator CreateLocator( 
   LPCTSTR pstrLocator  
); 
static CGopherLocator CreateLocator( 
   LPCTSTR pstrServerName, 
   LPCTSTR pstrDisplayString, 
   LPCTSTR pstrSelectorString, 
   DWORD dwGopherType, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER  
);

Параметры

pstrDisplayString
Указатель на строку, содержащую имя документа или каталога gopher. Если параметр pstrDisplayStringNULL, возвращается каталог по умолчанию для сервера gopher.
pstrSelectorString
Указатель на строку селектора, которые должны быть переданы на сервер gopher для получения элемент. pstrSelectorString может быть NULL.
dwGopherType
Определяет, относится ли pstrSelectorString к каталогу или документ и ли запрос или gopher+ gopher. См. раздел атрибуты для структуры GOPHER_FIND_DATA в Windows SDK.
pstrLocator
Указатель на строке, указав файл, который нужно открыть. Обычно эта строка возвращается из вызова CGopherFileFind::GetLocator.
pstrServerName
Указатель на строку, содержащую имя сервера gopher.
nPort
Идентификационный номер порта из Интернета для данного соединения.

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

Объект CGopherLocator.

Заметки

Статическая версия функции-члена требуется, чтобы указать сервер, пока не статическая версия использует имя сервера из объекта соединения.

Gopher извлечения сведений из сервера, сначала приложение должно получить указатель gopher. Затем приложение должно рассматривать как непрозрачный указатель на маркер (т е приложение может использовать указатель, но не напрямую управлять или сравнить его). Обычно приложение использует указатель для вызовов к функции-члену CGopherFileFind::FindFile чтобы извлечь конкретную информацию.