GopherCreateLocatorW

セレクタ文字列の構成要素から Gopher または Gopher+ ロケータ文字列を作成する。(Unicode)

GopherCreateLocatorW lpszHost, nServerPort, lpszDisplayString, lpszSelectorString, dwGopherType, lpszLocator, lpdwBufferLength

lpszHost : [wstr] ホスト名、またはドット区切り 10 進 IP アドレス (例: 198.105.232.1) を格納した null 終端文字列へのポインタ。
nServerPort : [int] lpszHost にある Gopher サーバーが使用するポート番号 (ホストバイトオーダー)。nServerPort が INTERNET_INVALID_PORT_NUMBER の場合、既定の Gopher ポートが使用される。
lpszDisplayString : [wstr] 表示する Gopher 文書またはディレクトリを格納した null 終端文字列へのポインタ。本パラメータが NULL の場合、関数は Gopher サーバーの既定のディレクトリを返す。
lpszSelectorString : [wstr] 情報を取得するために Gopher サーバーに送信するセレクタ文字列へのポインタ。本パラメータには NULL を指定できる。
dwGopherType : [int] lpszSelectorString がディレクトリと文書のどちらを参照するか、また要求が Gopher+ か Gopher かを決定する。dwGopherType の値が 0 の場合、既定値である GOPHER_TYPE_DIRECTORY が使用される。Gopher 種別値のいずれかを指定できる。
lpszLocator : [wstr] ロケータ文字列を受け取るバッファへのポインタ。lpszLocator が NULL の場合、lpdwBufferLength に必要なバッファ長が返されるが、関数は他の処理を行わない。
lpdwBufferLength : [var] lpszLocator バッファの長さ (文字単位) を格納する変数へのポインタ。関数が戻ると、本パラメータにはバッファに書き込まれた文字数が格納される。GetLastError が ERROR_INSUFFICIENT_BUFFER を返した場合、本パラメータには必要な文字数が格納される。

(プラグイン / モジュール : wininet.dll)

解説

セレクタ文字列の構成要素から Gopher または Gopher+ ロケータ文字列を作成する。(Unicode)

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。拡張エラー情報を取得するには GetLastError または
InternetGetLastResponseInfo を呼び出す。

[備考]
Gopher サーバーから情報を取得するには、アプリケーションはまず Gopher サーバーから Gopher
「ロケータ」を取得しなければならない。アプリケーションが不透明なトークンとして扱うべきロケータは、通常、特定の情報を取得するための
GopherFindFirstFile 関数の呼び出しに使用される。WinINet API の他のすべての側面と同様に、本関数は
DllMain やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは GopherCreateLocator
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報