---
title: HTL_thread_mutex_trylock
description: "尝试锁定互斥锁。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0117.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0117.html
indexId: d7567ec56c146eb78a10953efd6b0f3e0ea321f6deaee44a13d8830e33c09df974
---
# HTL_thread_mutex_trylock

尝试锁定互斥锁。

#### 接口定义

int HTL_thread_mutex_trylock(HTL_thread_mutex_t *thread_mutex);


#### 描述

HTL_thread_mutex_trylock()尝试锁定互斥锁thread_mutex。如果此函数返回HTL_THREAD_SUCCESS，则调用者获取互斥锁。如果调用者未能获取锁，则返回HTL_THREAD_ERR_MUTEX_LOCKED。如果thread_mutex是递归的，同一个调用者可以通过thread_mutex获得多个级别的所有权。thread_mutex保持锁定状态，直到thread_mutex解锁的次数与所有权级别相同。


#### 参数

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


#### 返回值

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


#### 示例

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