GopherGetAttributeW

サーバーから特定の属性情報を取得する。(Unicode)

GopherGetAttributeW hConnect, lpszLocator, lpszAttributeName, lpBuffer, dwBufferLength, lpdwCharactersReturned, lpfnEnumerator, dwContext

hConnect : [intptr] InternetConnect から返された Gopher セッションへのハンドル。
lpszLocator : [wstr] 属性情報を返す Gopher サーバー上の項目を識別する null 終端文字列へのポインタ。
lpszAttributeName : [wstr] 返す属性名を指定するスペース区切り文字列へのポインタ。lpszAttributeName が NULL の場合、GopherGetAttribute はすべての属性に関する情報を返す。
lpBuffer : [var] 属性情報を取得するアプリケーション定義のバッファへのポインタ。
dwBufferLength : [int] lpBuffer バッファのサイズ (TCHAR 単位)。
lpdwCharactersReturned : [var] lpBuffer バッファに読み取られた文字数を格納する変数へのポインタ。
lpfnEnumerator : [int] ロケータの各属性を列挙する GopherAttributeEnumerator コールバック関数へのポインタ。本パラメータは省略可能である。NULL の場合、Gopher 属性情報のすべてが lpBuffer に格納される。lpfnEnumerator が指定されている場合、コールバック関数はオブジェクトの属性ごとに 1 回呼び出される。
dwContext : [int] 本操作を任意のアプリケーションデータと関連付けるアプリケーション定義の値。

(プラグイン / モジュール : wininet.dll)

解説

サーバーから特定の属性情報を取得する。(Unicode)

[戻り値]
要求が満たされた場合は TRUE を、そうでない場合は FALSE を返す。拡張エラー情報を取得するには GetLastError または
InternetGetLastResponseInfo を呼び出す。

[備考]
一般に、アプリケーションは GopherFindFirstFile または InternetFindNextFile
を呼び出した後に本関数を呼び出す。lpBuffer パラメータのサイズは MIN_GOPHER_ATTRIBUTE_LENGTH
の値以上でなければならない。WinINet API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは GopherGetAttribute
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報