UDTをシリアル化された形式で返し、操作が成功した場合は0、それ以外の場合は-1を返します。
構文規則
int FNC_UdtSerialize (UDT_HANDLE udt, BYTE *buffer, FNC_LobLength_t num_bytes, FNC_LobLength_t *actual_length)
構文要素
- udt
- UDTのハンドル。
- buffer
- シリアル化されたデータを含むユーザー割り当てのバッファ。
- num_bytes
- 読み取るバイト数。
- actual_length
- バッファに書き込まれた実際のバイト数。
使用上の注意
この関数を呼び出す前に、次の手順を行ないます。
- FNC_UdtGetSerializeSizeを呼び出してシリアル化されたUDTのサイズを取得します。
- FNC_UdtGetSerializeSizeによって戻されたサイズを使用してシリアル化されたデータを保持するバッファを割り当てます。バッファのサイズはシリアル化されたデータすべてを保持するのに十分な大きさでなければならず、1回のFNC_UdtSerializeの呼び出しで読み込む必要があります。
- FNC_UdtSerializeにこのバッファを渡します。
UDTがシリアル化/非シリアル化をサポートしていない場合、この問合わせは失敗します。