ACAPI_LibPart_PatternSearch
로드된 라이브러리들 중에서 등록된 라이브러리 파트들을 검색합니다.
GSErrCode ACAPI_LibPart_PatternSearch ( const API_LibPart* ancestor, const GS::UniString& pattern, API_LibPart result[50], Int32* numFound );
파라미터
- ancestor
- [in] 검색할 라이브러리 파트 타입입니다.
- pattern
- [in] 로드된 라이브러리들 중에서 검색할 패턴입니다.
- result
- [out] 처음 발견한 50개의 라이브러리 파트들이 저장된 배열입니다.
- numFound
- [out] 발견한 라이브러리 파트들의 개수입니다.
리턴 값
NoError
- 함수가 성공적으로 완료되었습니다. 라이브러리 파트를 찾았습니다. (또는
createIfMissing
이true
일 경우 레퍼런스가 성공적으로 생성되었습니다) APIERR_BADPARS
ancestor
가NULL
,numFound
가NULL
입니다. 또는pattern
이 비어 있습니다.APIERR_BADID
- 주어진
typeID
또는 조상ownUnID
를 따라 검색한 라이브러리 파트가 없습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 로드된 라이브러리들 중에서 라이브러리 파트들을 검색하는 데 사용합니다.
검색 패턴은 1개 이상의 단어 또는 인용 부호 안의 표현식이 될 수 있습니다.
라이브러리 파트들은 이 문서의 라이브러리 파트 서브타입 챕터에서 설명한 대로 서브타입 계층을 따라 분류된다는 것을 기억하시기 바랍니다.
확장 가능한 서브타입 시스템은 라이브러리 파트의 typeID
기반 구분을 쓸모없게 만들었지만,
내부 조상 노드들에 대한 parentUnID
대신 서브타입 별로 검색하기 위해 이 필드를 사용할 수도 있습니다.
(이 경우 APILib_ObjectID
는 Model Element에 해당하고, API_ZombieLibID
는 General Object subtype을 의미한다는 것을 참고 바랍니다)
요구사항
- 버전: API 16 또는 이후
- 헤더: ACAPinc.h
참고사항
API_LibPart
ACAPI_LibPart_Get, ACAPI_LibPart_Create
ACAPI_LibPart_Search
API 함수