次の方法で共有

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-terminated 文字列、またはドット付き 10 進数 IP アドレス (198.105.232.1 など) へのポインター。

[in] nServerPort

lpszHost の Gopher サーバー 存在するポート番号 (ホストバイト順)。 nServerPort INTERNET_INVALID_PORT_NUMBER場合は、既定の Gopher ポートが使用されます。

[in] lpszDisplayString

表示する Gopher ドキュメントまたはディレクトリを含む null-terminated 文字列へのポインター。 このパラメーターが NULL場合、関数は Gopher サーバーの既定のディレクトリを返します。

[in] lpszSelectorString

情報を取得するために Gopher サーバーに送信するセレクター文字列へのポインター。 このパラメーターは NULLできます。

[in] dwGopherType

lpszSelectorString がディレクトリまたはドキュメントを参照しているかどうか、および要求が Gopher+ か Gopher かを判断します。 既定値 GOPHER_TYPE_DIRECTORY は、dwGopherType の値 0 の場合に使用されます。 これは、の gopher 型の値のいずれかになります。

[out] lpszLocator

ロケーター文字列を受け取るバッファーへのポインター。 lpszLocator が NULL場合、lpdwBufferLength は必要なバッファー長を受け取りますが、関数は他の処理を実行しません。

[in, out] lpdwBufferLength

lpszLocator バッファーの長さを文字で表す変数へのポインター。 関数が戻ると、このパラメーターはバッファーに書き込まれた文字数を受け取ります。 GetLastError が ERROR_INSUFFICIENT_BUFFERを返す場合、このパラメーターは必要な文字数を受け取ります。

戻り値

成功した場合 TRUE を返し、それ以外の場合は FALSE 返します。 拡張エラー情報を取得するには、GetLastError 呼び出すか、InternetGetLastResponseInfoを呼び出します。

備考

Gopher サーバーから情報を取得するには、アプリケーションが最初に Gopher サーバーから Gopher の "ロケーター" を取得する必要があります。

アプリケーションが不透明なトークンとして扱う必要があるロケーターは、通常、GopherFindFirstFile 関数を呼び出して特定の情報を取得するために使用されます。

WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。

注意 WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、Microsoft Windows HTTP Services (WinHTTP)を使用します。
 

手記

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GopherCreateLocator を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

WinINet Functions の