ACAPI_Attribute_GetUserData

속성에 부착된 사용자 데이터를 가져옵니다.

    GSErrCode  ACAPI_Attribute_GetUserData (
        API_Attr_Head*             attrHead,
        API_AttributeUserData*     userData
    );

 

파라미터

attrHead

[in] 속성의 헤더입니다. (typeID와 index 필드만 사용함)

userData

[in/out] 사용자 데이터에 대한 포인터입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

전달된 파라미터들 하나 이상이 NULL입니다.

APIERR_BADPLATFORMSIGN

플랫폼 기호가 포함된 사용자 데이터가 유효하지 않습니다. (범위 밖)

APIERR_MEMFULL

메모리가 부족합니다.

APIERR_NOUSERDATA

호출자 모듈에 의해 부착된 사용자 데이터가 없습니다.

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

 

설명

이 함수는 속성에 부착된 사용자 데이터를 가져오는 데 사용합니다. 속성에 부착된 데이터를 가져오려면 DDD 레코드의 typeID와 index 필드들을 채워야 합니다.

호출자는 userData->dataHdl 필드를 할당해서는 안 됩니다. 함수 자체에 의해서 할당되어야 합니다. 그러나 사용 후에는 호출자에 의해 파괴되어야 합니다!

속성 레코드에 데이터를 저장하려면 ACAPI_Attribute_SetUserData 함수를 사용하십시오.

 

요구사항

버전: API 4.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_Attr_Head, API_AttributeUserData,
ACAPI_Attribute_SetUserData,
속성 관리자, API 함수