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