Opens a new section to write into the Library Part under creation.

    GSErrCode  ACAPI_LibPart_NewSection (
        const API_LibPartSection*     section



[in] Parameters of the new section.


Return Values

The function has completed with success.
No scratch file has been opened by the ACAPI_LibPart_Create function.

For other common API errors see the API Errors.



This function is used to open a new section to write into the Library Part opened to create.

This function is allowed to call between the ACAPI_LibPart_Create and ACAPI_LibPart_Save functions only, while creating a Library Part from scratch. The identifier of the section must be defined in the API_LibPartSection parameter. The section data is passed through the sectionHandle parameter.

This is the other way to add sections to the library part, where the section is opened, then data is added with repetitive calls to the ACAPI_LibPart_WriteSection function, and finally it is closed with the ACAPI_LibPart_EndSection function call.

Refer to the ACAPI_LibPart_AddSection to add a section in one step.

Do not nest these function calls. Always close the opened section with ACAPI_LibPart_EndSection before you open an other.



See the example of the ACAPI_LibPart_Create function.



Version: API 1.3 or later
Header: ACAPinc.h


See Also

ACAPI_LibPart_WriteSection, ACAPI_LibPart_EndSection, ACAPI_LibPart_Create, ACAPI_LibPart_AddSection, ACAPI_LibPart_Save,
LibPart Manager, API Functions