GopherCreateLocatorW 関数 (wininet.h)
[ GopherCreateLocator 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。
セレクター文字列のコンポーネント パーツから Gopher または Gopher+ ロケーター文字列を作成します。
構文
BOOL GopherCreateLocatorW(
[in] LPCWSTR lpszHost,
[in] INTERNET_PORT nServerPort,
[in] LPCWSTR lpszDisplayString,
[in] LPCWSTR lpszSelectorString,
[in] DWORD dwGopherType,
[out] LPWSTR lpszLocator,
[in, out] LPDWORD lpdwBufferLength
);
パラメーター
[in] lpszHost
ホストの名前を含む null で終わる文字列、またはドット付きの 10 進数の IP アドレス (198.105.232.1 など) へのポインター。
[in] nServerPort
lpszHost の Gopher サーバーがホストバイト順に格納されているポート番号。 nServerPort がINTERNET_INVALID_PORT_NUMBER場合は、既定の Gopher ポートが使用されます。
[in] lpszDisplayString
表示する Gopher ドキュメントまたはディレクトリを含む null で終わる文字列へのポインター。 このパラメーターが NULL の場合、関数は Gopher サーバーの既定のディレクトリを返します。
[in] lpszSelectorString
情報を取得するために Gopher サーバーに送信するセレクター文字列へのポインター。 このパラメーターは、NULL でもかまいません。
[in] dwGopherType
lpszSelectorString がディレクトリまたはドキュメントを参照するかどうか、および要求が Gopher+ か Gopher かを決定します。 dwGopherType の値が 0 の場合、既定値GOPHER_TYPE_DIRECTORYが使用されます。 これは、 gopher 型の値のいずれかになります。
[out] lpszLocator
ロケーター文字列を受け取るバッファーへのポインター。 lpszLocator が NULL の場合、lpdwBufferLength は必要なバッファー長を受け取りますが、関数は他の処理を実行しません。
[in, out] lpdwBufferLength
lpszLocator バッファーの長さを文字で表す変数へのポインター。 関数が戻ると、このパラメーターはバッファーに書き込まれた文字数を受け取ります。 GetLastError がERROR_INSUFFICIENT_BUFFERを返す場合、このパラメーターは必要な文字数を受け取ります。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 拡張エラー情報を取得するには、 GetLastError または InternetGetLastResponseInfo を呼び出します。
注釈
Gopher サーバーから情報を取得するには、アプリケーションが最初に Gopher サーバーから Gopher "locator" を取得する必要があります。
アプリケーションが不透明なトークンとして扱う必要があるロケーターは、通常、 GopherFindFirstFile 関数を呼び出して特定の情報を取得するために使用されます。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
注意
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GopherCreateLocator を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |