CInternetFile::ReadString
更新 : 2007 年 11 月
改行文字が見つかるまで、文字ストリームを読み出します。
virtual BOOL ReadString(
CString& rString
);
virtual LPTSTR ReadString(
LPTSTR pstr,
UINT nMax
);
パラメータ
pstr
読み出した行を受け取るバッファへのポインタ。nMax
読み出す最大文字数。rString
読み出した行を受け取る CString オブジェクトへの参照。
戻り値
CInternetFile オブジェクトから読み出したテキスト データを保持するバッファへのポインタを返します。このメソッドに渡されるバッファのデータ型にかかわらず、そのデータに対する操作 (たとえば、Unicode への変換など) は一切行われないので、void* 型が返されたかのように、返されたデータを目的の構造体に変換する必要があります。
データをまったく読み出さないでファイルの終端 (EOF) に達した場合は、NULL を返します。ブール値のときに、データをまったく読み出さないでファイルの終端に達した場合は、FALSE を返します。
解説
pstr パラメータで参照されるメモリへ結果の行を格納します。nMax で指定される文字の最大数に達すると、文字の読み出しを停止します。バッファには、必ず、終端の NULL 文字が入ります。
最初に SetReadBufferSize を呼び出さずに ReadString を呼び出した場合は、4096 バイトのバッファを受け取ります。
例外
このメソッドは、CInternetException* 型の例外をスローできます。
必要条件
ヘッダー : afxinet.h