CInternetFile::Seek
あらかじめ開いているファイルのポインターを移動します。
virtual ULONGLONG Seek(
LONGLONG lOffset,
UINT nFrom
);
パラメーター
lOffset
ファイル ポインターを移動するバイト単位のオフセット。nFrom
オフセットの相対参照。 次のいずれかの値を指定します。CFile::begin ファイル ポインターをファイルの先頭から lOff バイトの位置へ移動します。
CFile::current ファイル ポインターをファイルの現在の位置から lOff バイトの位置へ移動します。
CFile::end ファイル ポインターをファイルの末尾から lOff バイト移動します。 既存のファイルの中にシークするためには、lOff は負の値である必要があります。正の値の場合は、ファイルの終端を越えて移動します。
戻り値
要求した位置が正常な場合は、ファイルの開始位置からの新しいバイト オフセットを返します。それ以外の場合には、値は不定となり、CInternetException オブジェクトがスローされます。
解説
Seek 関数を使用すると、相対的または絶対的に指定した量だけポインターを移動することによって、ファイルの内容にランダムにアクセスできます。 シーク中は、データは実際には読み取られません。
現時点でこのメンバー関数は、CHttpFile オブジェクトに関連するデータに対してのみ、サポートされています。 FTP または gopher 要求に対しては、サポートされていません。 このようなサポートされていないサービスに対して Seek を呼び出した場合、Win32 エラー コードの ERROR_INTERNET_INVALID_OPERATION が返されます。
ファイルが開かれたときのファイル ポインターの位置は、ファイルの先頭であるオフセット 0 です。
注意
Seek を使用すると、暗黙に Flush が呼び出されます。
例外
このメソッドは、CInternetException* 型の例外をスローできます。
使用例
基本クラスの実装の例を参照してください (CFile::Seek)。
必要条件
**ヘッダー:**afxinet.h