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 で終わる文字列、またはドット付きの 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 では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

Note

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

関連項目

WinINet 関数