fsetpos

設定資料流位置指標。

語法

int fsetpos(
   FILE *stream,
   const fpos_t *pos
);

參數

stream
FILE 結構的指標。

pos
位置指標儲存區。

傳回值

如果成功，fsetpos 會傳回 0。 失敗時，函式會傳回非零值，並將 設定 errno 為下列其中一個資訊清單常數（定義于 ERRNO 中。H： EBADF ，這表示無法存取檔案，或指向 的物件 stream 不是有效的檔案結構;或 EINVAL ，這表示 或 pos 傳遞了不正確值 stream 。 如果傳入不正確參數，這些函式會叫用不正確參數處理常式，如參數驗證 中所述 。

如需傳回碼的詳細資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

函式會將 fsetpos 的檔案位置指標 stream 設定為 的值 pos ，這是在 對 之前呼叫 fgetpos 中取得的 stream 。 函式會清除檔案結尾指標，並復原 對 stream 的任何影響 ungetc 。 呼叫 fsetpos 之後，上的下一個作業 stream 可能是輸入或輸出。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

函式	必要的標頭
fsetpos	<stdio.h>

如需相容性詳細資訊，請參閱相容性。

範例

請參閱 的 fgetpos 範例。

另請參閱

資料流 I/O
fgetpos