ACAPI_Command_Test
커맨드의 가용성을 테스트합니다.
GSErrCode ACAPI_Command_Test (
const API_ModulID* mdid,
GSType cmdID,
Int32 cmdVersion
);
파라미터
- mdid
- [in] 대상 애드온의 식별자입니다. 'MDID' 리소스로 정의합니다.
- cmdID
- [in] 테스트할 커맨드의 식별자입니다.
- cmdVersion
- [in] 필수 커맨드 버전입니다.
리턴 값
NoError- 커맨드가 설치되어 있습니다. 호출될 수 있습니다.
APIERR_BADPARSmdid파라미터가NULL입니다.APIERR_MODULNOTINSTALLED- 참조된 애드온이 설치되어 있지 않습니다.
APIERR_MODULCMDNOTSUPPORTED- 참조된 커맨드가 대상 애드온에 의해 지원되지 않습니다.
APIERR_MODULCMDVERSNOTSUPPORTED- 요청한 커맨드 버전이 너무 새로운 것입니다; 대상 애드온이 지원하지 않습니다.
다른 공통 오류들에 대해서는 오류 코드들의 리스트를 보십시오.
설명
이 커맨드는 애드온의 커맨드의 가용성을 확인하는 데 사용합니다.
다른 애드온의 요청한 커맨드가 이용할 수 있는지 여부를 확인하기 위해 이 함수를 호출하십시오. 결과에 따라, 예를 들면 당신은 당신의 애드온의 인터페이스를 변경할 수 있습니다. 다음 경우들이 있을 수 있습니다:
- 커맨드가 설치되어 있는 경우,
- 대상 애드온이 설치되어 있지 않은 경우,
- 대상 애드온이 설치되어 있지만, 커맨드를 지원하지 않는 경우,
- 대상 애드온이 설치되어 있고 커맨드를 지원하지만, 커맨드 버전이 올바르지 않은 경우.
다른 애드온을 호출하는 것에 대한 자세한 사항을 보려면 ACAPI_Command_Call 함수를 참조하십시오.
더 자세한 것은 통신 관리자의 페이퍼를 참조하십시오.
예제
다음 샘플은 표준 DWF In-Out 애드온의 서비스들이 현재 이용 가능한지 확인합니다:
API_ModulID mdid = { 1198731108, 3847165392 }; // DWF In-Out 애드온의 MDID
GSErrCode err = ACAPI_Command_Test (&mdid, 'DWFO', 4);
if (err != NoError) {
if (err == APIERR_MODULNOTINSTALLED) {
// DWF In-Out 애드온이 로드되어 있지 않습니다.
} else {
// DWF In-Out 애드온의 비호환 버전
}
}
요구사항
- 버전: API 3.1 또는 이후
- 헤더: ACAPinc.h
