nrac_resource_create()
摘要
在网络中创建一个资源对象。
语法
nrac_resource_create (net_handle, name, capacity, client_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
net_handle |
Nrac_Net_Handle |
目标网络上下文的句柄 |
name |
const char * |
资源名称(仅用于报告) |
capacity |
double |
资源名义上能够支撑的消费者单位数 |
client_state_ptr |
void * |
用于将资源与客户应用程序中的其他状态关联的方式。不需要时使用 OPC_NIL。 |
返回类型
Nrac_Resource_Handle
表示新资源对象的句柄。OPC_NIL 表示创建失败,通常是由于内存不足。
头文件
nrac.h
详情
资源表示网络的物理或逻辑构件,例如节点、链路或信道。资源随后可用于支撑资源消费者,通常是流量。最初,资源对象只是存在于网络之中,与任何消费者都没有关联。该对象具有三个属性,可以随时通过其他 NRAC 函数查询:
name仅用于报告。(如有需要,此字段可以为空。)capacity以对客户应用程序有意义的方式,指定资源名义上可以支撑的消费者负载单位数。不会对该限值进行强制约束,它仅用于记账。client_state_ptr是指向应用程序希望与此资源关联的任意数据的指针。例如,如果该资源表示一条链路,它可以是指向相应链路数据结构的指针。NRAC 包本身不使用此指针——不需要时传入OPC_NIL。