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(由调用者指定的任意值)

返回类型

PrgT_Mutex_Result

成功或失败代码;为表 6 “Mutex Package Symbolic Constants”中的值之一。

头文件

prg_mt.h

详情

此函数尝试锁定指定的 mutex 对象。如果该 mutex 已被锁定且无法共享(例如非递归 mutex,或读/写 mutex 未被读者锁定),调用进程将被阻塞,直到 mutex 解锁并可用。等待 mutex 可用的进程按照其请求加锁的先后顺序被阻塞和释放。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com