---
title: HTL_thread_mutex_lock
description: "锁定互斥锁。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0116.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0116.html
indexId: ddc3f8efbbdca4c272b911c063d94c99968b50da907b62a35142d062db34a03576
---
# HTL_thread_mutex_lock

锁定互斥锁。

#### 接口定义

int HTL_thread_mutex_lock(HTL_thread_mutex_t *thread_mutex);


#### 描述

HTL_thread_mutex_lock()用于锁定互斥锁thread_mutex。如果返回成功，则调用者获取互斥锁。如果互斥锁已经被锁定，则调用者将被阻塞，直到互斥锁可用。

如果互斥锁thread_mutex是递归的，同一个调用者可以通过互斥锁获得多个级别的所有权。互斥锁会保持锁定状态，直到互斥锁被解锁的次数与所有权级别一样多。


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| thread\_mutex | HTL\_thread\_mutex\_t \* | 互斥句柄的地址。 | 输入 |


#### 返回值

- HTL_THREAD_SUCCESS：成功。
- 其他：失败。见错误码定义。


#### 示例

```
int ret;
    ret = HTL_thread_mutex_lock(&mutex);
    if ( ret != HTL_THREAD_SUCCESS) return;
```