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.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GopherGetAttribute を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |