次の方法で共有


GopherGetAttributeA 関数 (wininet.h)

[GopherGetAttribute 関数は、[要件] セクションで指定したオペレーティング システムで使用できます。

サーバーから特定の属性情報を取得します。

構文

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [in]  DWORD_PTR                   dwContext
);

パラメーター

[in] hConnect

InternetConnectによって返される Gopher セッションへのハンドル。

[in] lpszLocator

属性情報を返す Gopher サーバーの項目を識別する、null終了文字列へのポインター。

[in] lpszAttributeName

返される属性の名前を指定するスペース区切り文字列へのポインター。 lpszAttributeName が NULL場合、GopherGetAttribute はすべての属性に関する情報を返します。

[out] lpBuffer

属性情報の取得元となるアプリケーション定義バッファーへのポインター。

[in] dwBufferLength

lpBuffer バッファーのサイズ (TCHAR)。

[out] lpdwCharactersReturned

lpBuffer バッファーに読み込まれる文字数を含む変数へのポインター。

[in] lpfnEnumerator

GopherAttributeEnumerator へのポインター ロケーターの各属性を列挙するコールバック関数です。 このパラメーターは省略可能です。 NULL場合、すべての Gopher 属性情報が lpBufferに配置されます。 lpfnEnumerator 指定すると、オブジェクトの属性ごとにコールバック関数が 1 回呼び出されます。

コールバック関数は、呼び出しごとに 1 つの GOPHER_ATTRIBUTE_TYPE 構造体のアドレスを受け取ります。 列挙コールバック関数を使用すると、アプリケーションで Gopher 属性情報を解析する必要がなくなります。

[in] dwContext

この操作を任意のアプリケーション データに関連付けるアプリケーション定義の値。

戻り値

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

備考

一般に、アプリケーションは、GopherFindFirstFile 呼び出した後、または InternetFindNextFileを した後、この関数を呼び出します。

lpBuffer パラメーターのサイズは、MIN_GOPHER_ATTRIBUTE_LENGTHの値以上である必要があります。

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

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

手記

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

必要条件

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

関連項目

WinINet Functions の