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

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

[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 サービス (WinHTTP) を使用します。
 

注意

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

WinINet 関数