Ets_State_Block_String_Size_Read()
注意: 需要 OPNET Development Kit
摘要
获取指定状态块中即将读取的字符串的大小。
语法
Ets_State_Block_String_Size_Read (block_hndl, string_size_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
block_hndl |
EtsT_State_Block_Handle |
要从中读取的状态块 |
string_size_ptr |
int * |
指向即将读取的字符串的大小的指针。 |
返回类型
EtsT_Compcode
若成功则返回 EtsC_Compcode_Success,否则返回 EtsC_Compcode_Failure(见详情)。
头文件
ets_pstate.h
详情
本函数将客户端状态块中下一个字符串的大小(减去结尾 null 字符所占的 1)写入 string_size_ptr。
以下信息适用于所有 Ets_State_Block_<…>_Read() 函数:
- 块(block)提供了对原始文件的抽象。可以把块看作文件的一段(但没有 seek 函数)。通过块存储的数据将是跨平台的,因此在 Windows 平台上向块写入一个整数,在 Linux 平台上运行时仍能正确读取。
- 在以下任一情况下,Read 都会返回
EtsC_Compcode_Failure:- 块中已没有剩余数据
- 目标变量(本函数中为
string_size_ptr)的指针为空 - 块句柄无效
- 如果发生失败,将发出一个可恢复错误。