prg_mt_mutex_lock()
摘要
尝试锁定一个 mutex。
语法
prg_mt_mutex_lock (mutex_ptr, option, rank_ptr, description, lock_id)
| 参数 | 类型 | 说明 |
|---|---|---|
mutex_ptr |
PrgT_Mutex * |
要锁定的 mutex 对象。 |
option |
int |
如果该 mutex 是读/写 mutex,此参数应为 PRGC_MT_MUTEX_LOCK_READER PRGC_MT_MUTEX_LOCK_WRITER 之一;否则被忽略 |
rank_ptr |
int * |
如果该 mutex 启用了等级检查,且加锁尝试失败,这里将被填入该进程中等级最低的 mutex。如果设置为 PRGC_NIL,则不会存储等级值。 |
description |
char * |
如果 mutex 加锁尝试失败,这里将是该进程锁定的等级最低的 mutex 的描述副本。该参数应当是一个足够大、可存储任意描述的 char 数组。如果设置为 PRGC_NIL,则不会复制描述。 |
lock_id |
int |
加锁进程的 ID(由调用者指定的任意值) |
返回类型
成功或失败代码;为表 6 “Mutex Package Symbolic Constants”中的值之一。
头文件
prg_mt.h
详情
此函数尝试锁定指定的 mutex 对象。如果该 mutex 已被锁定且无法共享(例如非递归 mutex,或读/写 mutex 未被读者锁定),调用进程将被阻塞,直到 mutex 解锁并可用。等待 mutex 可用的进程按照其请求加锁的先后顺序被阻塞和释放。