服务器句柄¶
ACI_ATTR_EXTERNAL_NAME¶
- 模式：
读/写
- 描述：
外部名称是存储在sys.props $ .value $中的用户友好全局名称，其中name ='GLOBAL_DB_NAME'。 除非所有数据库都使用网络目录服务注册其名称，否则不能保证它是唯一的。
可以与服务器交换数据库名称以进行分布式事务协调。 只有在发出 ACISessionBegin 调用时打开数据库的情况下，才可以访问服务器数据库名称。
- 属性数据类型：
oratext ** / oratext *
ACI_ATTR_NONBLOCKING_MODE¶
- 模式：
读/写
- 描述：
此属性确定阻止模式。 读取时，如果服务器上下文处于非阻塞模式，则属性值返回TRUE。 设置后，它将切换非阻塞模式属性。 仅在调用 ACISessionBegin 或 ACILogon2 之后，才必须设置此属性。 否则，将返回错误。
备注：ACI支持这个属性的设置，但不会生效。
- 属性数据类型：
ub1 * /ub1
ACI_ATTR_SERVER_STATUS¶
- 模式：
读
- 描述：
返回服务器句柄的当前状态。
- 属性数据类型：
ub4 *
- 取值范围：
- ACI_SERVER_NORMAL-到服务器的活动连接。 连接上的最后一个呼叫通过了。 无法保证下一个呼叫会通过。
- ACI_SERVER_NOT_CONNECTED-没有与服务器的连接。
ACI_ATTR_RECEIVE_TIMEOUT¶
- 模式：
读/写
- 描述：
客户端等待来自数据库服务器的响应数据的时间（以毫秒为单位）。 当设置为零值时，将禁用超时功能，并且客户端可能会等待很长时间才能获得数据库服务器的响应。
ACI暂未实现此属性。
- 属性数据类型：
ub4*/ub4
ACI_ATTR_SEND_TIMEOUT¶
- 模式：
读/写
- 描述：
客户端等待完成向数据库服务器发送操作的时间（以毫秒为单位）。 当设置为零值时，将禁用超时功能，并且客户端可能会等待很长时间才能完成将数据发送到数据库服务器的过程。
ACI暂未实现此属性。
- 属性数据类型：
void *
ACI_ATTR_USER_MEMORY¶
- 模式：
读
- 描述：
如果为句柄分配了额外的内存，则此属性返回指向用户内存的指针。 对于未分配额外内存的那些句柄，将返回NULL指针。
- 属性数据类型：
void *