ACAPI_LibPart_GetNum
등록된 라이브러리 파트들의 수를 리턴합니다.
GSErrCode ACAPI_LibPart_GetNum ( Int32* count );
파라미터
- count
- [out] 라이브러리 파트들의 수입니다.
리턴 값
NoError
- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS
count
가NULL
입니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 현재 이용 가능한 라이브러리 파트들의 수를 가져오는 데 사용합니다. 서로 다른 타입의 라이브러리 파트들의 수는 이 함수로 가져올 수 없습니다; 당신은 가져오고 싶은 모든 라이브러리 파트들을 다 세어 보아야 합니다. 예를 들면, 라이브러리 내 창들의 개수.
라이브러리 파트들은 인덱스를 통해 참조됩니다. 이 함수는 그러한 참조의 최대 수를 리턴합니다; 유효한 인덱스는 [1 … count
] 범위 안에 있습니다.
특수 값 0은 빈 개구부의 경우처럼 빈 라이브러리 파트를 참조하는 데 사용됩니다.
예제
API_LibPart libPart; Int32 i, count; GSErrCode err; err = ACAPI_LibPart_GetNum (&count); if (!err) { for (i = 1; i <= count; i++) { BNZeroMemory (&libPart, sizeof (API_LibPart)); libPart.index = i; err = ACAPI_LibPart_Get (&libPart); if (!err) { ACAPI_WriteReport ((const char *) GS::UniString (libPart.docu_UName).ToCStr (), false); } if (libPart.location != NULL) delete libPart.location; } }
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h