# 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;
```