---
title: kupl_queue_acquire
description: "使用序号获取队列句柄"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_235.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_235.html
indexId: d9ff1f4c1d293d54969337f2994a4d4b23b8d2f672437900863ffdd20c7b6acc67
---
# kupl_queue_acquire

使用序号获取队列句柄

#### 接口定义

kupl_queue_h kupl_queue_acquire(int index);


#### 参数


**表1 参数定义**

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| index | int | 队列的序号 使用 KUPL\_ASYNC\_SYNC 表示同步队列 | 输入 |


#### 返回值

成功：返回 queue 句柄

失败：返回 nullptr


#### 示例

```
#include <stdio.h> 
#include "kupl.h" 

int main() 
{ 
    kupl_queue_h queue = kupl_queue_acquire(1); 
    kupl_queue_destroy(queue); 
    return 0; 
}
```

上述示例演示了获取一个序号为 1 的队列句柄，然后销毁的流程。获取队列后可以不销毁，在程序结束后会自动销毁。