共用方式為

mmioSeek 函式 (mmiscapi.h)

  • 發行項

mmioSeek函式會變更使用mmioOpen函式開啟的檔案中目前檔案位置。

語法

LONG mmioSeek(
  HMMIO hmmio,
  LONG  lOffset,
  int   iOrigin
);

參數

hmmio

要搜尋之檔案的檔案控制碼。

lOffset

要變更檔案位置的位移。

iOrigin

旗標，指出 lOffset 所指定的位移如何解譯。 定義下列值：

名稱 描述
SEEK_CUR
 從目前檔案位置搜尋 lOffset 位元組。
SEEK_END
 從檔案結尾搜尋 lOffset 位元組。
SEEK_SET
 從檔案開頭搜尋 lOffset 位元組。

傳回值

傳回相對於檔案開頭的新檔案位置，以位元組為單位。 如果發生錯誤，則傳回值為 –1。

備註

在檔案中搜尋不正確位置，例如超過檔案結尾，可能不會造成 mmioSeek 傳回錯誤，但可能會導致檔案上的後續 I/O 作業失敗。

若要找出檔案的結尾，請呼叫 mmioSeek ，並將 lOffset 設定為零， 而 iOrigin 設定為 SEEK_END。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mmiscapi.h (包括 Mmiscapi.h、Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll