ACAPI_Attribute_GetDef

속성에 대한 확장된 정보를 가져옵니다.

    GSErrCode  ACAPI_Attribute_GetDef (
        API_AttrTypeID        typeID,
        short                 index,
        API_AttributeDef*     defs
    );

 

파라미터

typeID

[in] 속성의 타입입니다.

index

[in] 속성의 인덱스입니다.

defs

[out] 속성에 대한 확장된 정보입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

전달된 파라미터(defs)가 NULL입니다.

APIERR_BADID

속성 타입이 유효하지 않습니다; 설명을 보십시오.

APIERR_BADINDEX

속성 인덱스가 유효하지 않습니다.

APIERR_DELETED

속성이 데이터베이스에 존재하지 않습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 지정한 속성의 상세 정보를 리턴하는 데 사용합니다.

이 함수는 라인, 채우기, 복합, 레이어, 구역(Zone) 카테고리에 대해서만 유효합니다. 다른 타입의 속성들은 확장된 정보를 갖고 있지 않습니다; 모든 데이터는 API_Attribute structure를 통해 전달될 수 있습니다. 속성의 기본 파라미터들을 가져오려면 ACAPI_Attribute_Get 함수를 보십시오.

더 이상 필요하지 않으면 리턴된 데이터 핸들들을 폐기하는 것을 잊지 마십시오. 이를 위해 ACAPI_DisposeAttrDefsHdls 함수를 사용하십시오.

 

예제

API_Attribute        attrib;
API_AttributeDefs    defs;
short                ltypeIndex;
GSErrCode            err;

/* "Wave" 라인 타입에 대한 모든 정보를 가져옴 */

BNZeroMemory (&attrib, sizeof (API_Attribute));
BNZeroMemory (&defs, sizeof (API_AttributeDefs));

attrib.header.typeID = API_LinetypeID;
CHCopyC ("Wave", attrib.header.name);
err = ACAPI_Attribute_Get (&attrib);
if (err == NoError)
    err = ACAPI_Attribute_GetDef (attrib.header.typeID, attrib.header.index, &defs);
ACAPI_DisposeAttrDefsHdls (&defs);

 

요구사항

버전: API 1.3 또는 이후

헤더: ACAPinc.h

 

참고사항

API_AttrTypeID, API_Attribute, API_AttributeDef,
ACAPI_Attribute_Get, ACAPI_DisposeAttrDefsHdls,
속성 관리자, API 함수