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
[out] lpBuffer
属性情報の取得元となるアプリケーション定義バッファーへのポインター。
[in] dwBufferLength
lpBuffer バッファーのサイズ (TCHAR)。
[out] lpdwCharactersReturned
lpBuffer バッファーに読み込まれる文字数を含む変数へのポインター。
[in] lpfnEnumerator
GopherAttributeEnumerator へのポインター ロケーターの各属性を列挙するコールバック関数です。 このパラメーターは省略可能です。 NULL
コールバック関数は、呼び出しごとに 1 つの GOPHER_ATTRIBUTE_TYPE 構造体のアドレスを受け取ります。 列挙コールバック関数を使用すると、アプリケーションで Gopher 属性情報を解析する必要がなくなります。
[in] dwContext
この操作を任意のアプリケーション データに関連付けるアプリケーション定義の値。
戻り値
要求が満た
備考
一般に、アプリケーションは、GopherFindFirstFile
lpBuffer パラメーターのサイズは、MIN_GOPHER_ATTRIBUTE_LENGTHの値以上である必要があります。
WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。
手記
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GopherGetAttribute を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wininet.h |
ライブラリ | Wininet.lib |
DLL | Wininet.dll |
関連項目
WinINet Functions の