Ets_State_Block_Objhandle_Read()

Note: Requires OPNET Development Kit

Abstract

Reads object handle value from cross-platform block storage.

Syntax

Ets_State_Block_Objhandle_Read (block_handle, objhandle_ptr)
Argument Type Description
block_handle EtsT_State_Block_Handle handle to block of cross-platform data
objhandle_ptr EtsT_Obj_Handle * Pointer to variable where read value is stored

Return Type

EtsT_Compcode

EtsC_Compcode_Success if read operation was successful, EtsC_Compcode_Failure otherwise.

ets_pstate.h

Details

Blocks provide an abstraction away from a raw file. A block can be thought of as if it were a piece of a file (but there are no seek functions). Data stored via blocks will be cross platform. For example, a double written to a block on a Windows platform will read in correctly on a Linux platform.

Read will return EtsC_Compcode_Failure in any of the following situations:

  • there is no more data left in the block
  • the pointer for the target variable is null
  • the block handle is invalid

If there was a failure, a recoverable error will be issued.

There are no seek functions; however, the block will (likely) be cached in memory.

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com