APIAny_GetMainGroupGuidID
중첩된(nested) 그룹 요소의 최상위 레벨 그룹을 리턴합니다.
GSErrCode ACAPI_Goodies (
APIAny_GetMainGroupGuidID,
const API_Guid* groupGuid,
API_Guid* mainGroupGuid
);
파라미터
- groupGuid
- [in] 그룹 요소의 guid입니다.
- mainGroupGuid
- [out] 테스트된 그룹을 포함하는 그룹 계층 내 루트 그룹의 guid입니다.
리턴 값
NoError- 함수가 성공적으로 완료되었습니다.
APIERR_BADPARSgroupGuid또는mainGroupGuid파라미터가NULL입니다.APIERR_BADID- 전달된
groupGuid가 기존 그룹 요소를 참조하지 않습니다.
다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.
설명
이 함수는 중첩된(nested) 그룹 요소의 최상위 레벨 그룹을 가져오는 데 사용합니다. 만약 전달된 그룹이 다른 그룹의 일부가 아니라면, 이 함수는 전달된 그룹 guid를 메인 그룹 guid로 리턴합니다.
예제
bool GetMainGroupOfAnElement (const API_Element& element, API_Element* mainGroup)
{
bool grouped = false;
API_Guid mainGroupGuid = APINULLGuid;
ACAPI_Goodies (APIAny_GetMainGroupGuidID, const_cast<API_Guid*> (&element.header.groupGuid), &mainGroupGuid);
if (mainGroupGuid != APINULLGuid) {
grouped = true;
char msgStr[128];
sprintf (msgStr, "Main Group Guid: %s", static_cast<const char *> (APIGuid2GSGuid (mainGroupGuid).ToUniString ().ToCStr ()));
ACAPI_WriteReport (msgStr, false);
if (mainGroup != NULL) {
BNZeroMemory (mainGroup, sizeof (API_Element));
mainGroup->header.guid = mainGroupGuid;
ACAPI_Element_Get (mainGroup);
}
}
return grouped;
}
요구사항
- 버전: API 12 또는 이후
- 헤더: APIdefs_Goodies.h
