ACAPI_Attribute_Search
이름으로 속성을 검색합니다.
GSErrCode ACAPI_Attribute_Search (
API_Attr_Head* attrHead
);
파라미터
- attrHead
- [in/out] 검색할 속성입니다. 헤더의
typeID와name또는guid필드들을 통해 식별됩니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARS- 전달된 파라미터가
NULL입니다; attrHead APIERR_BADID- 속성 타입이 유효하지 않습니다.
APIERR_BADNAME- 주어진 이름을 가진 속성이 존재하지 않습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 이름 또는 GUID로 속성을 검색하는 데 사용합니다. 
리턴 직후, 헤더의 index와 다른 적용 가능한 필드들이 세트됩니다.
name 필드입니다.
이 함수는 펜들을 검색하는 데에는 사용할 수 없습니다; 펜들은 이름이나 GUID를 갖고 있지 않습니다.
예제
API_Attribute attrib;
BNZeroMemory (&attrib, sizeof (API_Attribute));
/* "Wave" 라인 타입의 인덱스를 알아냄 */
attrib.header.guid = GSGuid2APIGuid (GS::Guid ("35DE8210-A51E-43AE-9837-8CF3A01E8F63"));
GSErrCode err = ACAPI_Attribute_Search (&attrib.header);
if (err == NoError) {
char msgStr[512];
sprintf (msgStr, "[%d] %s", attrib.header.index, attrib.header.name);
ACAPI_WriteReport (msgStr, true);
}
요구사항
- 버전: API 1.3 또는 이후
- 헤더: ACAPinc.h
