設定資料流位置指標。
語法
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 的範例。