ACAPI_LibPart_NewSection
생성 중인 라이브러리 파트로 들어가는 새로운 섹션을 작성하기 위해 엽니다.
GSErrCode ACAPI_LibPart_NewSection ( const API_LibPartSection* section );
파라미터
- section
- [in] 새로운 섹션의 파라미터들입니다.
리턴 값
NoError
- 함수가 성공적으로 완료되었습니다.
APIERR_GENERAL
- ACAPI_LibPart_Create 함수로 열린 스크래치 파일이 없습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 생성하기 위해 열었던 라이브러리 파트로 들어가는 새로운 섹션을 작성하기 위해 엽니다.
이 함수는 스크래치로부터 라이브러리를 만드는 동안 ACAPI_LibPart_Create와 ACAPI_LibPart_Save 함수 사이에서만 호출할 수 있습니다.
섹션의 식별자는 API_LibPartSection 파라미터에서 정의되어야 합니다.
섹션 데이터는 sectionHandle
파라미터를 통해 전달되어야 합니다.
이것은 섹션이 열려 있을 때 라이브러리 파트로 섹션들을 추가할 수 있는 다른 방법입니다. 그리고 나서 ACAPI_LibPart_WriteSection 함수의 반복 호출을 통해 데이터가 추가됩니다. 마지막으로 ACAPI_LibPart_EndSection 함수 호출로 섹션을 닫습니다.
한 번에 하나의 섹션을 추가하려면 ACAPI_LibPart_AddSection을 참조하십시오.
이 함수 호출을 중첩시키지 마십시오. 항상 다른 섹션을 열기 전에 ACAPI_LibPart_EndSection으로 열린 섹션을 닫아야 합니다.
예제
ACAPI_LibPart_Create 함수의 예제를 보십시오.
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h
참고사항
API_LibPartSection,
ACAPI_LibPart_WriteSection, ACAPI_LibPart_EndSection, ACAPI_LibPart_Create, ACAPI_LibPart_AddSection, ACAPI_LibPart_Save,
라이브러리 파트 관리자, API 함수