_locking
鎖定或解除鎖定檔案的位元組。
語法
int _locking(
int fd,
int mode,
long nbytes
);
參數
fd
檔案描述項。
mode
要執行的鎖定動作。
nbytes
要鎖定的位元組數目。
傳回值
如果成功，_locking 會傳回 0。 -1 的傳回值表示失敗，在此情況下 errno 會設定為下列其中一個值。
errno 值 |
Condition |
|---|---|
EACCES |
鎖定違規 (檔案已鎖定或解除鎖定)。 |
EBADF |
檔案描述項無效。 |
EDEADLOCK |
鎖定違規。 指定 或 _LK_RLCK 旗標且_LK_LOCK在嘗試 10 次之後無法鎖定檔案時傳回。 |
EINVAL |
指定給 _locking 的引數無效。 |
如果失敗是由於不正確的參數，例如無效的檔案描述元，則會叫用無效的參數處理程式，如參數驗證中所述。
備註
函 _locking 式會鎖定或解除鎖定 nbytes 所 fd指定檔案的位元組。 鎖定檔案中的位元組可防止其他處理序存取這些位元組。 所有鎖定或解除鎖定都會從檔案指標的目前位置開始，並繼續進行下一個 nbytes 位元組。 可以鎖定超過檔尾的位元組。
mode 必須是下列其中一個指令清單常數，這些常數定義於Locking.h中。
mode 值 |
效果 |
|---|---|
_LK_LOCK |
鎖定指定的位元組。 如果無法鎖定位元組，程式會在1秒後立即嘗試。 如果 10 次嘗試之後無法鎖定位元組，則常數會傳回錯誤。 |
_LK_NBLCK |
鎖定指定的位元組。 如果無法鎖定位元組，常數會傳回錯誤。 |
_LK_NBRLCK |
與 _LK_NBLCK 相同。 |
_LK_RLCK |
與 _LK_LOCK 相同。 |
_LK_UNLCK |
解除鎖定指定的位元組，這些位元組之前必須已鎖定。 |
無法重疊之檔案的多個區域可以鎖定。 要解除鎖定的區域之前必須已鎖定。 _locking 不會合併相鄰區域;如果兩個鎖定的區域相鄰，則必須個別解除鎖定每個區域。 區域只能短暫鎖定，而且必須在關閉檔案或結束程式之前解除鎖定。
根據預設，此函式的全域狀態會限定於應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。
需求
| 常式 | 必要的標頭 | 選擇性標頭 |
|---|---|---|
_locking |
<io.h> 和 <sys/locking.h> | <errno.h> |
如需相容性詳細資訊，請參閱相容性。
程式庫
所有版本的 C 執行階段程式庫。
範例
// crt_locking.c
/* This program opens a file with sharing. It locks
* some bytes before reading them, then unlocks them. Note that the
* program works correctly only if the file exists.
*/
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/locking.h>
#include <share.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <io.h>
int main( void )
{
int fh, numread;
char buffer[40];
/* Quit if can't open file or system doesn't
* support sharing.
*/
errno_t err = _sopen_s( &fh, "crt_locking.txt", _O_RDONLY, _SH_DENYNO,
_S_IREAD | _S_IWRITE );
printf( "%d %d\n", err, fh );
if( err != 0 )
exit( 1 );
/* Lock some bytes and read them. Then unlock. */
if( _locking( fh, LK_NBLCK, 30L ) != -1 )
{
long lseek_ret;
printf( "No one can change these bytes while I'm reading them\n" );
numread = _read( fh, buffer, 30 );
buffer[30] = '\0';
printf( "%d bytes read: %.30s\n", numread, buffer );
lseek_ret = _lseek( fh, 0L, SEEK_SET );
_locking( fh, LK_UNLCK, 30L );
printf( "Now I'm done. Do what you will with them\n" );
}
else
perror( "Locking failed\n" );
_close( fh );
}
輸入︰crt_locking.txt
The first thirty bytes of this file will be locked.
範例輸出
No one can change these bytes while I'm reading them
30 bytes read: The first thirty bytes of this
Now I'm done. Do what you will with them