nrac_event_create()
摘要
在网络上下文中创建一个新事件。
语法
nrac_event_create (net_handle, description, client_state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
net_handle |
Nrac_Net_Handle |
目标网络上下文的句柄 |
description |
const char * |
事件的自由文本描述。可选——仅用于报告。 |
client_state_ptr |
void * |
用于将事件与客户应用程序中的其他状态关联的方式。不需要时使用 OPC_NIL。 |
返回类型
Nrac_Event_Handle
新事件的句柄。OPC_NIL 表示创建失败,通常是由于内存不足。
头文件
nrac.h
详情
事件可用于表达消费者使用资源的条件。换句话说,可以声明消费者无条件地使用某个资源,或者只在特定条件下使用该资源。在后一种情况下,事件对象用于表示所关注的条件。典型情形是某个资源(例如链路)发生故障。当此类故障发生时,流量会被重新路由,因而需要其他资源来支撑它。例如,这可用于表达共享保护(shared protection)的概念。