2.10. 단말 리소스

2.10.1. 단말 리소스 개요

용어 정의

단말 리소스 이미지, 사운드, 주소록 등 특정 데이터 포맷을 가지면서 단말 영역에 저장된 데 이터들을 통칭. 단말 리소스 그룹 리소스들을 사업자 자체적인 서비스 이름(그림친구, 벨소리, 사진, 음성녹음)에 따라 분류해 놓은 그룹. 단말 리소스 함수 단말 리소스 그룹 및 단말 리소스의 접근 및 이용이 가능한 함수. 리소스 그룹 이름 리소스 그룹을 나타내는 이름이다. 리소스 이름 리소스의 이름으로 리소스 그룹에서 리소스를 구별하는 유일한 식별자이다. OEM에서 생성하며 동일 리소스 그룹에서 리소스 이름은 중복될 수 없다. 리소스 UI(User Interface) 이름 리소스가 UI 화면 상에 나타내는 이름이다. 응용 프로그램에서도 생성 가능하며, 동일 리소스그룹에서 중복이 허용된다. 리소스 그룹 리스트 각각의 리소스 그룹의 이름을 ‘₩0’문자로 구분한 리소스 그룹의 리스트. 마지막 에는 ‘₩0’문자가 2개 연속으로 온다. 단말 리소스 함수의 출력 값으로 사용되는 형식이다. 리소스 리스트 각각이 리소스 이름을 ‘₩0’문자로 구분한 리소스 이름 리스트. 마지막에는 ‘₩0’ 문자가 2개 연속으로 온다. 단말 리소스 함수의 출력 값으로 사용되는 형식이다. 폰북개인 PHONEBOOK/PRIVATE 리소스 그룹의 리소스로서 단말기의 주소록이다. 폰북그룹 PHONEBOOK/GROUP 리소스 그룹의 리소스로서 단말기의 주소록 그룹이다. 단축번호 PHONEBOOK/SHORTKEY 리소스 그룹의 리소스로서 폰북개인의 특정 전화번 호에 할당된, 전화번호보다 간단한 번호로서, 이를 이용하여 보다 간단하게 전화 를 걸 수 있게 한다. 그룹 Lock 리소스 그룹이 Lock되어 있는 상태. 그룹 Lock된 리소스 그룹에 접근하는 API 를 실행하기 전에는 비밀번호를 확인하여야 한다. 그룹 Lock은 개별 Lock과는 무관하게 설정/해제한다. 개별 Lock 리소스가 Lock되어 있는 상태. 개별 Lock된 리소스에 접근하는 API를 실행하기 전에는 비밀번호를 확인하여야 한다. 개별 Lock은 그룹 Lock과는 무관하게 설정 /해제한다. Lock 설정 리소스 그룹에 그룹 Lock 설정 또는 리소스에 개별 Lock 설정. Lock 설정시에는 비밀번호를 확인하여야 한다. Lock 해제 리소스 그룹에 그룹 Lock 해제 또는 리소스에 개별 Lock 해제. Lock 해제시에는 비밀번호를 확인하여야 한다. Lock 상태 그룹 Lock이 지원되는 리소스 그룹의 경우 그룹 Lock이 설정되었는지 그렇지 않은지를 나타내는 상태. 또는 개별 Lock이 지원되는 리소스 그룹의 리소스의 경우 리소스에 개별 Lock이 설정되었는지 그렇지 않은지를 나타내는 상태. Lock 상태와 리소스 접근 리소스의 데이터를 읽거나 쓰고 지우는 등 리소스에 접근할 때, 리소스가 포함 된 리소스 그룹이 그룹 Lock되어 있거나, 리소스가 개별 Lock되어 있으면 비밀 번호를 확인해야 한다. 비밀번호 단말기에 설정된 비밀번호. 이미지 리소스 화면에 보여지는 그림, 사진등의 리소스 (Animated Bitmap, 사운드가 없는 동영 상 등 여러 이미지가 연속적으로 보여지는 리소스 포함) 사운드 리소스 벨, 음악등 소리가 재생되는 리소스 이미지와 사운드가 모두 포함된 리소스 화면에 보여지는 이미지가 있고 소리가 재생되는 리소스 단말 특정 상태 대기(IDLE), 전화 수신(INCOMING), 단말 구동(POWERON), 단말 종료 (POWEROFF), 브라우저 구동(BROWSERON), 브라우저 종료(BROWSEROFF) 의 6가지 단말 상태 Unique ID 망제공자나 Contents Provider에 의해 할당된 리소스의 유일한 ID 그룹 정보 단말 리소스 함수를 통해 얻을 수 있는 특정 리소스 그룹의 정보. 그룹 정보는 리소스 그룹과 그룹 정보 타입에 따라 달라진다. 그룹 정보 타입 그룹 정보의 종류. 단말 리소스 함수를 통해 지정한 그룹 정보 타입에 따라, 지 정한 리소스 그룹의 그룹 정보를 얻어 올 수 있다. 리소스 정보 단말 리소스 함수를 통해 얻을 수 있는 특정 리소스의 정보. 리소스 정보는 리 소스와 리소스 정보 타입에 따라 달라진다. 리소스 정보 타입 리소스 정보의 종류. 단말 리소스 함수를 통해 지정한 리소스 정보 타입에 따라, 지정한 리소스의 리소스 정보를 얻어 올 수 있다. 검색어 단말 리소스 함수를 통해 리소스 검색시 사용하는 질의어(query). 리소스 검색시 단말 리소스 함수는 검색어 타입에 따라 검색어 문자열을 가진 리소스의 리스트 를 반환한다. 검색어 타입 단말 리소스 함수를 통해 리소스 검색시 사용하는 검색어의 종류. 리소스 검색 시 검색어 타입에 따라 각기 다른 종류의 검색이 이루어지게 된다. 검색어 타입 과 검색어로 리소스를 검색한다. 검색 모드 검색 모드에 따라 주어진 문자열과 정확히 일치하는지를 검색하거나, 또는 주어 진 문자열을 포함하는지를 검색한다. 쓰기 모드 단말 리소스 write시 새로운 리소스를 생성할 것인지, 기존 리소스를 덮어 쓸 것 인지를 결정 wCard 표준 명함 데이터 포맷인 vCard 3.0을 기반으로 하여 단말의 주소록에서 필요한 정보를 확장하여 정의한 WIPI 주소록 포맷을 말한다. 가 개요 이미지, 사운드, 주소록 등 특정 데이터 포맷을 가지면서 단말 영역에 저장된 데 이터들을 통칭하여 단말 리소스(이하 리소스)라 한다. 리소스들을 사업자 자체적인 서비스 이름(그림친구, 벨소리, 사진, 음성녹음)에 따라 분류해 놓은 그룹을 단말 리소스 그룹 (이하 리소스 그룹)이라 한다. 모든 리소스는 각각의 리소스 그룹에 속하게 된다. 모든 리소스는 하나의 저장 공간 영역으로 관리가 되어야 한다 단말 리소스 함수들은 WIPI 어플리케이션이 리소스 그룹과 리소스에 접근하는 통로를 제공한다. 나 함수 기능 및 목록

<표 2-10-1> 함수 기능 및 목록

기 능 목 록 단말 리소스 관리 MH_termResGetFormat MH_termResGetSize MH_termResGetUIName MH_termResRead MH_termResWrite MH_termResDelete MH_termResRegister MH_termResGetRegisteredInfo MH_termResGetInfo MH_termResSearch MH_termResGetSupportedGroups MH_termResGetCount 단말 리소스 그룹 관리 MH_termResGetList MH_termResGetGroupInfo MH_termResGetFreeSpace MH_termResGetGroupLockState MH_termResGetLockState 단말 리소스 보안 MH_termResSetGroupLockState MH_termResSetLockState MH_termResCheckPassword 단말 리소스 기타 MH_termResExecuteCmd 다 단말 리소스 그룹 각 리소스 그룹은 다수의 리소스들로 이루어져 있으며, 각 리소스들은 특정 데 이터 포맷을 가질 수 있다. 미리 정의된 리소스 그룹은 다음과 같다. “PICTUREMATE” – 그림친구 “MUSICBELL” – 벨소리 “PHOTO” – 사진 “VOICE” – 음성녹음 “PHONEBOOK/PRIVATE” – 주소록(개인) “PHONEBOOK/GROUP” – 주소록(그룹) “PHONEBOOK/SHORTKEY” – 단축번호 “ALARM” – 알람 설정 정보 “BLACKLIST” – 블랙리스트. 전화번호에 소리/진동/램프 상태를 설정한다. “SMSDATA/SENT” – SMS 발신 데이터 “SMSDATA/RECV” – SMS 수신 데이터 라 리스트 형식 단말 리소스 함수가 하나의 매개 변수에 다수의 데이터를 입력 또는 출력 값으 로 사용할 때, 각각의 데이터 구분은 ‘₩0’(NULL)문자로 하며 마지막에는 ‘₩0’문 자가 2개 연속으로 온다. 예1) “PHOTO₩0MUSICBELL₩0₩0” 예2) “mypicture01₩0mypicture02₩0…mypictuer100₩0₩0” 예3) “MUSICBELL;mymusicbell₩0PICTUREMATE;mypicture₩0₩0” 예4) “0114441234₩001199995555₩0Friend₩0Family₩0₩0” 예5) “1₩0100₩0₩0” 마 단말 리소스 이름 형식 단말 리소스에 대한 모든 접근은 리소스 이름을 통해 이루어지므로 OEM은 어 플리케이션이 리소스 그룹 내에서 리소스 이름을 유일한 식별자로 사용할 수 있 도록 중복되지 않게 리소스 이름을 제공하여야 한다. 어플리케이션은 리소스를 새로 생성할 때 리소스 이름을 지정할 수 없으며, OEM이 제공하는 리소스 이름 을 받아 사용한다

리소스 이름 형식

리소스 이름은 유일해야 한다는 조건 이외에 다른 제한은 없다.

고정된 리소스 이름

아래의 리소스 이름은 고정된 것으로 해당 그룹의 해당 리소스 데이터를 접근하 기 위해서는 주어진 리소스 이름을 사용하여야 한다. <표 2-10-2 >고정된 리소스 이름 리소스 그룹 리소스 이름 비고 PHONEBOOK/SHORTKEY 지정된 단축 번호 문자열 예) “5”, “49”

리소스 UI(User Interface) 이름

리소스가 UI 화면 상에 나타내는 이름이다. 리소스 그룹에 따라, 리소스에 UI이 름이 없는 리소스 그룹이 있을 수 있다. (단, PHONEBOOK/SHORTKEY그룹은 UI이름을 단축번호로 사용한다.)

리소스 이름과 UI 이름

리소스에는 리소스 이름과 UI이름이 있다. 다음은 리소스 이름과 UI이름의 설명 이다. 리소스 이름은 리소스 그룹내에서 리소스를 구분하는 유일한 식별자이다. PHONEBOOK/SHORTKEY 그룹은 리소스 이름이 규격에 정해져 있고, 이를 제 외한 나머지 그룹의 리소스 이름은 단말에서 관리하게 된다. 어플리케이션은 단 말이 제공하는 리소스 이름의 리스트을 받아서 사용하며, 리소스를 새로 생성할 때에도 단말이 넘겨주는 리소스 이름을 받아서 사용한다. 리소스 이름은 인덱스 가 될 수도 있고 어떠한 형태의 문자열이 와도 상관 없으며, 단말은 오직 어플 리케이션에게 리소스를 접근할 수 있도록 중복되지 않는 유일한 이름만 제공해 주면 된다. 반면에 UI이름은 UI를 통해서 사용자에게 보여지는 이름이다. 예를 들어 PHOTO그룹의 경우 카메라 촬영 후 얻은 이미지에 사용자가 직접 입 력하여 설정한 이름이 UI이름이다. 어플리케이션이 사용자에게 단말에 저정된 PHOTO그룹의 이미지 리스트를 보여줄 경우 UI이름이 단말 화면에 나타나게 된 다. 또는 사용자가 이름을 설정하지 않고 단말이 사진의 이름을 알아서 생성해 주는 경우라 해도, 어플리케이션이 사진 리스트를 보여 주어야 하는 경우라면, 각 사진의 이름 리스트를 보여주어야 한다. 이럴 경우 UI이름이 필요하게 된다. 또 다른 예로 MUSICBELL그룹의 벨소리라면 각각의 리소스마다 “내 마음의 별”, “소양강 처녀”, “돌아와요 부산항에” 등의 사용자에게 보여지는 이름이 있을 것이 다. 이렇게 사용자에게 보여지는 이름이 UI이름이다. 그러나 리소스에 따라서 UI이름이 없는 리소스도 있을 수 있다. 예를 들어 SMS DATA 등의 경우가 이에 해당한다. SMS DATA는 보통 메시지 리스트에서, 메시 지의 처음 일부분을 사용자에게 보여주므로 UI이름이 필요하지 않게 된다. 즉 리소스 이름은 리소스를 이용하기 위한 식별자이고, UI이름은 UI를 통해서 사 용자에게 보여지는 이름이다. 하나의 리소스 그룹내에서 리소스 이름은 중복이 불가능하며, UI이름은 중복이 가능하다. 리소스 이름은 모든 리소스에 부여되며, UI이름은 UI이름이 필요한 리소스그룹의 리소스에게만 부여된다. 리소스 이름은 어플리케이션이 설정 및 변경할 수 없으며, UI이름은 어플리케이션이 설정 및 변 경이 가능하다. 바 MIME 타입 및 리소스 데이터 포맷 각 단말 리소스는 다음과 같이 MIME 타입과 데이터 포맷을 가지고 있다. <표 2-10-3 >이미지 포맷 MIME 타입 데이터 포맷 image/bmp Bitmap 이미지 포맷 image/gif GIF 이미지 포맷 image/jpeg JPEG 이미지 포맷 image/png PNG 이미지 포맷 <표 2-10-4 >Animation 포맷 MIME 타입 데이터 포맷 anim/sis SIS 이미지 포맷 <표 2-10-5 >동영상 포맷 MIME 타입 데이터 포맷 video/MPEG4 Mpeg4 video/H.263 H.263 video/H.264 H.264 <표 2-10-6 >사운드 포맷 MIME 타입 데이터 포맷 Qualcomm_CMX Qualcomm CMX Yamaha_MA1 Yamaha MA1 Yamaha_MA2 Yamaha MA2 Yamaha_MA3 Yamaha MA3 Single Channel Format Yamaha_MA5 Yamaha MA5 Yamaha_SMAF Yamaha Single Channel Format Yamaha_SMAF-Phrase Yamaha Multi Channel Format Yamaha_SMAF-Audio Yamaha SMAF-Audio Format audio/MIDI MIDI audio/MP3 MP3 audio/TONE Tone audio/FREQTONE Frequency Tone IS96 QCELP-8K IS96A QCELP-8K IS733 QCELP-13K IS127 EVRC-8K G.723.1 G.723.1 audio/AAC AAC audio/AAC+ AAC+ AMR-WB WCDMA용 음성 코덱 AMR-NB <표 2-10-7 >폰북개인, 폰북그룹 및 SHORTKEY 포맷 MIME 타입 데이터 포맷 Phonebook/private wCard 문자열 Phonebook/group 실제 그룹 이름 문자열 : UI를 통해서 보여지는 이름 Phonebook/shortkey 단축번호 데이터 = <폰북개인의 리소스 이름> + ‘/’ + <wCard TEL Type의 Type 및 Value> 예) 리소스 이름이 “김철수”인 폰북개인 리소스의 집전화번호 가 02-1234-5678인 경우 “김철수/TEL;TYPE=home:0212345678” <표 2-10-8 >Alarm 포맷 MIME 타입 데이터 포맷 alarm 다음의 6가지 포맷 중 하나가 된다. 1. 알람을 한번만 설정 :연월일시분(yyyymmddhhmm) 2. 매년 반복적 알람 : “EY” + 월일시분(mmddhhmm) 3. 매월 반복적 알람 : “EM” + 일시분(ddhhmm) 4. 매주 반복적 알람 : “EW” + <요일구분자> + 시분(hhm) <요일구분자> : “SUN”, “MON”, “TUE”, “WED”, “THU”, “FRI”, “SAT” 5. 매일 반복적 알람 : “ED” + 시분(hhmm) 6. 매시간 반복적 알람 : “EH” + 분(mm) 예1) 2003년 12월 24일 23시 55분에 알람을 설정한 경 우 :“200312342355” 예2) 매년 12월 24일 23시 55분에 알람을 설정한 경우 : “EY12242355” 예3) 매월 24일 23시 55분에 알람을 설정한 경 우 :“EM242355” 예4) 매주 월요일 23시 55분에 알람을 설정한 경우 : “EWMON2355” 예5) 매일 23시 55분에 알람을 설정한 경우 : “ED2355” 예6) 매시간 55분에 알람을 설정한 경우 : “EH55” <표 2-10-9 >BLACKLIST 포맷 MIME 타입 데이터 포맷 blacklist blacklist 데이터 = NUMBER + ‘;’ + STATE NUMBER : 착신번호 (‘-‘가 없는 문자열 형태) STATE : blacklist 설정 상태 “SND” : 사운드 상태로 설정된 경우 “VIB” : 진동 상태로 설정된 경우 “LMP” : Lamp 상태로 설정된 경우 예) 011-1234-5678번을 Lamp 상태로 설정한 경우 “01112345678;LMP” <표 2-10-10 >SMS 착발신 데이터 포맷 MIME 타입 데이터 포맷 smsdata SMS 데이터 = INDEX + ‘₩0’ + STATE + ‘₩0’ + NUMBER + ‘₩0’ + DATA + ‘₩0’ + TIME + ‘₩0’ + ‘₩0’ INDEX : SMS 메시지의 내부 관리 번호 문자열 STATE : 메시지의 상태 ‘0’ : 새로운 메시지 ‘1’ : 이미 읽은 메시지 NUMBER : 발신자 또는 수신자 전화 번호 문자열 (‘-‘ 없음) DATA : ASCII 형식의 SMS 메시지 문자열 TIME : 착발신 시간 문자열 (년월일시분(yyyymmddhhmm) 형 태) 예) 2003년 05월 04일 12시 55분에 011-1234-5678번으로 부터 “Hello”라는 메시지가 새로 도착한 경우 “10₩00₩001112345678₩0Hello₩0200305041255₩0₩0” 사 단말 리소스 저장 공간 플랫폼에서 제공하는 단말 리소스 기능은 단말의 모든 리소스가 하나의 저장 공 간에 저장된다. 또한 MH_termResGetFreeSpace를 통하여 반환된 크기만큼의 저장 공간을 하나의 단말 리소스 그룹에서 모두 사용할 수도 있어야 한다. 아 단말 리소스 관리

리소스 그룹과 리소스

모든 리소스는 리소스 그룹 중 하나에 속하도록 구현하여야 한다.

단말 특정 상태에 리소스 설정

하나의 단말 특정 상태에 이미지 리소스와 사운드 리소스를 각각 설정할 수 있 도록 구현하여야 한다. 이미지와 사운드가 모두 포함된 리소스는 하나만 설정할수 있도록 구현되어야 한다.

PHONEBOOK/SHORTKEY 그룹의 리소스

단축번호 리소스는 단말이 제공하는 사용가능한 단축번호 중에서, 전화번호 설 정이 된 것만 리소스로 존재하도록 구현되어야 한다. 사용가능한 단축번호 중에 PHONEBOOK/SHORTKEY 그룹에 없는 단축번호는 전화번호 설정이 되어있지 않은 단축번호이다. 단축번호 리소스가 가리키고 있는 폰북개인의 전화번호나, 폰북개인이 삭제되면 해당 단축번호 리소스도 삭제되도록 구현되어야 한다.

단축번호

PHONEBOOK/SHORTKEY 그룹의 리소스 리스트를 얻어오면 그 시점에서 사용 하고 있는 (전화번호가 지정된) 단축번호를 알 수 있도록 구현되어야 한다. MH_termResGetGroupInfo 함수의 infoType을 “RANGE”로 하면 단말이 지원하는 단축번호를 반환하여야 한다. 여기서PHONEBOOK/SHORTKEY 그룹의 리소스 리스트에 없는 단축번호는 지정되지 않은 단축번호로 사용 가능한 단축번호로 제공하여야 한다.

폰북개인과 폰북그룹

어플리케이션이 폰북개인을 write할 때 폰북그룹 리스트에 없는 폰북그룹을 설 정하면 에러를 반환하여야 한다. 어플리케이션이 폰북개인에 폰북그룹을 설정하 면, 해당 폰북그룹에 속해있는 폰북개인 리스트 정보도 update되어야 한다. 자 단말 리소스 보안 기능

비밀번호 확인

어플리케이션은 그룹 Lock된 리소스 그룹의 리소스 데이터를 읽고 쓰고 지우거 나, 개별 Lock된 리소스의 데이터를 읽고 쓰고 지우는 등의 리소스 접근시에는, 사용자로부터 입력받은 비밀번호가 단말기에 설정된 비밀번호와 일치하는지 확 인한 후 하여야 한다. 또 Lock 설정/해제시에도 어플리케이션은 비밀번호를 확 인한 후 하여야 한다. 단말은 MH_termResCheckPassword 함수를 통해 비밀번 호 확인기능을 제공한다. 차 각 리소스 그룹별 적용 가능 함수 다음은 단말 리소스 API 중 리소스 그룹을 지정하는 API들의 지정 가능한 리소 스 그룹을 나타낸다. (리소스 그룹을 지정하지 않는 API는 다음 표와 무관하다.)

<표 2-10-11> 각 리소스 그룹별 적용 가능 함수

리소스 그룹 지정 가능한 API 모든 리소스 그룹 MH_termResGetCount MH_termResGetList MH_termResGetFormat MH_termResGetSize MH_termResRead MH_termResGetGroupLockState MH_termResSetGroupLockState MH_termResGetLockState MH_termResSetLockState MH_termResGetFreeSpace MH_termResGetGroupInfo (infoType에 따라 다르다) MH_termResSearch (queryType에 따라 다르다) PICTUREMATE MH_termResWrite MUSICBELL MH_termResDelete PHOTO MH_termResRegister VOICE MH_termResGetInfo MH_termResGetUIName PHONEBOOK/PRIVATE MH_termResWrite PHONEBOOK/SHORTKEY MH_termResDelete MH_termResGetUIName PHONEBOOK/GROUP MH_termResWrite MH_termResDelete MH_termResGetInfo MH_termResGetUIName ALARM MH_termResWrite BLACKLIST MH_termResDelete

Lock 상태

#define MH_TERMRES_GROUP_LOCK
#define MH_TERMRES_GROUP_UNLOCK
#define MH_TERMRES_PRIVATE_LOCK
#define MH_TERMRES_PRIVATE_UNLOCK

단말 리소스 그룹 및 단말 리소스의 Lock 상태를 나타낸다.

검색 모드

#define MH_TERMRES_EXTSRCH
#define MH_TERMRES_INCSRCH

단말 리소스 검색시 검색 모드를 결정한다.

쓰기 모드

#define MH_TERMRES_CREATE
#define MH_TERMRES_UPDATE

단말 리소스 Write시 쓰기 모드를 결정한다.

MH_termResGetSupportedGroups

프로토타입

M_Int32 MH_termResGetSupportedGroups(M_Byte* resGroup, M_Int32 bufSize)

설명

단말이 지원하는 리소스 그룹 리스트를 반환한다.

매개 변수

resGroup - [out] 리소스 그룹 리스트(Terminal Resource 모듈 포팅의 ‘리스트 형식’을 따른다.)
bufSize - [in] resGroup 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환값이 담길 버퍼 크기가 작을 경 우

부작용

없음

참고 항목

없음

MH_termResGetCount

프로토타입

M_Int32 MH_termResGetCount(M_Char* resGroupName)

설명

지정한 리소스 그룹에 속하는 리소스의 개수를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름

반환 값

성공

리소스 개수 실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResGetList

프로토타입

M_Int32 MH_termResGetList(M_Char* resGroupName, M_Byte* aszList,
M_Int32 bufSize)

설명

지정한 리소스 그룹에 속하는 리소스 리스트를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
aszList - [out] 리소스 이름 리스트 (Terminal Resource 모듈 포팅의 ‘리스트 형식’을 따른다.)
bufSize - [in] aszList 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환되는 문자열보다 전달한 버퍼크기가 작을때 발생
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResGetFormat

프로토타입

M_Int32 MH_termResGetFormat(M_Char* resGroupName, M_Char* resName, M_Char* rtnFormat, M_Int32 rtnFormatSize)

설명

지정한 리소스의 MIME 타입 문자열을 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름
rtnFormat - [out] MIME 타입 문자열
rtnFormatSize - [in] rtnFormat 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환되는 문자열보다 전달한 버퍼 크기가 작을때 발생
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResGetSize

프로토타입

M_Int32 MH_termResGetSize(M_Char* resGroupName, M_Char* resName)

설명

지정한 리소스의 데이터 크기를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름

반환 값

성공

리소스 크기 실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

MH_termResRead를 호출해서 리소스를 읽어올 때 필요한 버퍼를 할당하기 위 해서 사용된다.

MH_termResGetUIName

프로토타입

M_Int32 MH_termResGetUIName(M_Char* resGroupName, M_Char* resName, M_Char* uiName, M_Int32 uiNameSize)

설명

지정한 리소스의 UI 이름을 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름
uiName - [out] UI 상에 나타나는 이름
uiNameSize - [in] uiName 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환되는 문자열보다 전달한 버퍼 크기가 작을때 발생
M_E_NOTSUP - UI 이름을 지원하지 않는 리소스 그룹일 경우
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResRead

프로토타입

M_Int32 MH_termResRead (M_Char* resGroupName, M_Char* resName,
M_Byte* pData, M_Int32 bufSize)

설명

지정한 리소스의 데이터를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름
pData - [out] 리소스 데이터
bufSize - [in] pData 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환되는 데이터보다 전달한 버퍼크기가 작을때 발생
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

pData는 MH_termResGetSize()를 통해 얻어온 리소스의 크기만큼 Caller가 할 당한다.

MH_termResWrite

프로토타입

M_Int32 MH_termResWrite (M_Char* resGroupName, M_Char* resName,
M_Int32 nameSize, M_Char* uiName, M_Char* resFormat, M_Byte* pData, M_Int32 bufSize, M_Int32 mode)

설명

지정한 리소스 그룹에 리소스를 기록/갱신한다. 기록의 경우 새로 생성된 리소스 이름 을 반환하며, UI 이름을 주지 않으면 OEM에서 임의로 부여할 수 있다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in/out] 새로 생성되거나 기존에 존재하는 리소스 이름
nameSize - [in] resName 버퍼 크기
uiName - [in] UI 상에 나타나는 이름
resFormat - [in] 리소스의 MIME 타입
pData - [in] 리소스 데이터
bufSize - [in] pData 버퍼 크기
mode - [in] 쓰기 모드 MH_TERMRES_CREATE 리소스를 새로 생성한다. 이 경우 resName은 새로 생성된 리소스 이름이 반환된다. MH_TERMRES_UPDATE 기존 리소스에 덮어 쓴다. 이 경우 resName에 덮어 쓸 리소스 이름을 넣어준다. 복수개의 리소스를 WRITE할 경우 resName, uiName, pData 인자의 각 데이타는 ₩0 문자로 구분하고 마지막엔 ₩0문자 2개가 온다

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INSUFSPACE - 리소스 저장 공간 부족
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_ACCESSDENY - 사용자가 쓰기 권한이 없는 리소스일 경우
M_E_NOTSUP - 쓰기 기능을 지원하지 않는 리소스 그룹
M_E_INVALIDDATA - 데이터가 해당 데이터 포맷에 맞지 않음
M_E_SHORTBUF - resName이 출력일 때 버퍼 크기가 작은 경우
M_E_MAXCOUNT - 리소스 그룹에서 지원하는 최대 개수를 초과한 경우

부작용

MH_TERMRES_CREATE 모드시, OEM에서 UI이름에 대한 특별한 규칙이 있 거나 UI이름이 없는 리소스 그룹의 경우, 인자로 넘겨준 UI이름은 무시될 수 있다. MH_TERMRES_UPDATE 모드시, 리소스 그룹 이름, 리소스 이름, MIME 타입 이 존재하는 리소스의 정보와 모두 일치하는 경우에 함수가 동작하며 기존 데이터는 새로운 데이터로 업데이트된다. UI이름을 지원하는 리소스 그룹일 경우 UI이름을 지정해야 하며, 그렇지 않을 경우 에러(M_E_INVALID)를 반환해야 한다.

참고 항목

PHONEBOOK/SHORTKEY와 PHONEBOOK/GROUP은 UI 이름과 리소스 이름 이 같아야 한다.

MH_termResDelete

프로토타입

M_Int32 MH_termResDelete (M_Char* resGroupName, M_Char* resName)

설명

지정한 리소스를 삭제한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_ACCESSDENY - 사용자가 접근 권한이 없는 리소스일 경우
M_E_NOTSUP - 삭제 기능을 지원하지 않는 리소스 그룹
M_E_NODELETE - 삭제가 불가능한 리소스

부작용

없음

참고 항목

없음

MH_termResRegister

프로토타입

M_Int32 MH_termResRegister (M_Char* resGroupName, M_Char* resName, M_Char* szStatus)

설명

지정한 리소스를 단말 특정 상태에 설정한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름
szStatus - [in] 단말 특정 상태 “IDLE” 대기 “INCOMING” 전화 수신 “POWERON” 단말 구동 “POWEROFF” 단말 종료 “BROWSERON” 브라우저 구동 “BROWSEROFF” 브라우저 종료

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_ACCESSDENY - 사용자가 설정 권한이 없는 경우
M_E_INVALIDSTATUS - 리소스와 단말 특정 상태가 연관이 없는 경우
M_E_NOTSUP - Register 기능을 지원하지 않는 리소스 그룹

부작용

없음

참고 항목

없음

MH_termResGetRegisteredInfo

프로토타입

M_Int32 MH_termResGetRegisteredInfo (M_Byte* resList,
M_Int32 bufSize, M_Char* szStatus)

설명

단말 특정 상태에 설정된 리소스 그룹 이름과 리소스 이름을 반환한다.

매개 변수

resList - [out] 리소스 그룹과 리소스 이름의 리스트 리소스 그룹 이름, “;”, 리소스 이름 순으로 구성된다. 리소스가 두개일 경우 다음의 리소스 그룹이름과 리소스 이름의 구별은 Terminal Resource 모듈 포팅의 ‘리스트 형식’을 따른다. 예) “MUSICBELL;mymusicbell₩0₩0” “MUSICBELL;mymusicbell₩0PICTUREMATE;mypicture₩0₩0”
bufSize - [in] resList 버퍼 크기
szStatus - [in] 단말 특정 상태 “IDLE” 대기화면 “INCOMING” 전화 수신 화면 “POWERON” 단말 구동 화면 “POWEROFF” 단말 종료 화면 “BROWSERON” 브라우져 구동시 “BROWSEROFF” 브라우져 종료시

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_ACCESSDENY - 사용자가 설정 권한이 없는 경우
M_E_INVALIDSTATUS - 리소스와 단말 특정 상태가 연관이 없는 경우
M_E_NORES - 특정 상태에 설정된 리소스가 없을 경우
M_E_SHORTBUF - resNames 버퍼 크기가 작을 경우
M_E_NOTSUP - Register 기능을 지원하지 않는 리소스 그룹

부작용

없음

참고 항목

단말 특정 상태에 설정된 리소스는 최대 2개이다.

MH_termResGetGroupLockState

프로토타입

M_Int32 MH_termResGetGroupLockState (M_Char* resGroupName)

설명

지정한 리소스 그룹의 Lock 상태를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름

반환 값

성공

MH_TERMRES_GROUP_LOCK 해당 리소스 그룹이 그룹 Lock 설정 되어 있음. MH_TERMRES_GROUP_UNLOCK 해당 리소스 그룹이 그룹 Lock 설정 안되어 있음. 실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_NOTSUPPORTLOCK - 해당 리소스 그룹/리소스가 Lock 설정을 지원하지 않음
M_E_NOTSUPPORTGLOCK - 해당 리소스 그룹이 그룹 Lock은 지원하지 않음 (개별 Lock은 지원함)
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResGetLockState

프로토타입

M_Int32 MH_termResGetLockState (M_Char* resGroupName, M_Char* resName)

설명

지정한 리소스의 Lock상태를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름

반환 값

성공

MH_TERMRES_PRIVATE_LOCK 해당 리소스가 개별 Lock 설정 되어 있음. MH_TERMRES_PRIVATE_UNLOCK 해당 리소스가 개별 Lock 설정 안되어 있음. 실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_NOTSUPPORTLOCK - 해당 리소스 그룹/리소스가 Lock 설정을 지원하지 않음
M_E_NOTSUPPORTPLOCK - 해당 리소스 그룹이 개별 Lock은 지원하지 않음 (그룹 Lock은 지원함)
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResSetGroupLockState

프로토타입

M_Int32 MH_termResSetGroupLockState(M_Char* resGroupName,
M_Int32 state)

설명

지정한 리소스 그룹의 Lock 상태를 설정한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
state - [in] 그룹 Lock 설정/해제 MH_TERMRES_GROUP_LOCK 그룹 Lock 설정 MH_TERMRES_GROUP_UNLOCK 그룹 Lock 해제

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_NOTSUPPORTLOCK - 해당 리소스 그룹/리소스가 Lock 설정을 지원하지 않음
M_E_NOTSUPPORTGLOCK - 해당 리소스 그룹이 그룹 Lock은 지원하지 않음 (개별 Lock은 지원함)
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

MH_termResCheckPassword를 이용해 비밀번호를 확인한 후 사용한다.

MH_termResSetLockState

프로토타입

M_Int32 MH_termResSetLockState(M_Char* resGroupName, M_Char* resName, M_Int32 state)

설명

지정한 리소스의 Lock 상태를 설정한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
resName - [in] 리소스 이름
state - [in] 개별 Lock 설정/해제 MH_TERMRES_PRIVATE_LOCK 개별 Lock 설정 MH_TERMRES_PRIVATE_UNLOCK 개별 Lock 해제

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_NOTSUPPORTLOCK - 해당 리소스 그룹/리소스가 Lock 설정을 지원하지 않음
M_E_NOTSUPPORTPLOCK - 해당 리소스 그룹이 개별 Lock은 지원하지 않음 (그룹 Lock은 지원함)
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

MH_termResCheckPassword를 이용해 비밀번호를 확인한 후 사용한다.

MH_termResCheckPassword

프로토타입

M_Int32 MH_termResCheckPassword(M_Char* szPassword)

설명

지정한 비밀번호가 단말에 설정된 비밀번호와 일치하는지 확인한다.

매개 변수

szPassword - [in] 비밀번호

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INCORRECTPASSWORD - 비밀번호 불일치일 경우
M_E_INVALID - 전달한 매개변수가 잘못되었음

부작용

없음

참고 항목

없음

MH_termResGetFreeSpace

프로토타입

M_Int32 MH_termResGetFreeSpace(M_Char* resGroupName)

설명

단말 리소스 저장 공간의 남은 크기를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름

반환 값

성공

지정한 리소스 그룹의 저장 공간의 남은 크기 실패

M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_ERROR - 알 수 없는 이유로 실패
M_E_NOTSUP - 지원하지 않는 리소스 그룹.

부작용

없음

MH_termResGetGroupInfo

프로토타입

M_Int32 MH_termResGetGroupInfo(M_Char* resGroupName, M_Char* infoType, M_Byte* infoData, M_Int32 bufSize)

설명

지정한 리소스 그룹에 대하여 지정한 그룹 정보 타입의 그룹 정보를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름
infoType - [in] 그룹 정보 타입 (아래 참고 항목에 정의)
infoData - [out] 그룹 정보
bufSize - [in] infoData 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_SHORTBUF - 그룹 정보 버퍼 크기가 작을 경우
M_E_NOTSUPPORTTYPE - 해당 그룹은 지정한 그룹 정보 타입의 그룹 정보를지원하지 않음
M_E_NOENT - 지정한 그룹 정보 타입의 그룹 정보가 없음

부작용

다음의 참고 항목에 정의된 infoType에 해당하는 리소스 그룹만 resGroupName으로 지정 가능하다.

참고 항목

‘+’ : 앞뒤 문자열/문자를 strcat 하는 연산을 의미한다.

<표 2-10-12>

리소스 infoTyp 비고 그룹 e 모든 그룹 “MAXUINAMESI 지정한 리소스그룹에서 UI이름의 최대 저장 가능한 ZE” 길이를 문자열로 반환한다. PHONEBOOK/PRIV “MAXCOUNT” 지정한 리소스 그룹의 최대 저장 가능한 리소스 수 ATE 를 문자열로 반환한다. PHONEBOOK/GRO UP SMSDATA/SENT SMSDATA/RECV PHONEBOOK/SHO “RANGE” 단말기가 지원하는 단축번호의 시작 번호와 마지막 RTKEY 번호를 문자열로 반환한다. 반환 형식은 3.9.1을 따 르며, 시작 번호와 마지막 번호 순으로 반환한다. 예1)“1₩0100₩0₩0” (1번부터 100번까지의 번호를 단축번호로 사용할 수 있는 단말기) 예2)”0₩0200₩0₩0” (0번부터 200번까지의 번호를 단축번호로 사용할 수 있는 단말기) PHONEBOOK/GRO “IRREMOVABLE 삭제가 불가능한 리소스 리스트를 반환한다. 반환 UP ” 형식은 Terminal Resource 모듈 포팅의 ‘리스트 형 식’을 따른다. 삭제 불가능한 리소스가 없을 경우 에러(M_E_NOENT)를 반환한다. ‘PHONEBOOK/PRI “MAXTELCOUN 단말에 저장 가능한 최대 전화번호 수를 문자열로 VATE T” 반환한다. “TYPELIST” 단말이 지원하는 wCard Type의 리스트를 반환한다. 반환 형식은 Terminal Resource 모듈 포팅의 ‘리스 트 형식’을 따른다. “TYPECOUNT” 단말이 지원하는 wCard Type 수를 반환한다. “TYPEINFO” + wCard의 Type name에 해당하는 wCard Type의 정 ‘/’ + <Type 보를 반환한다. name> 반환 형식은 다음과 같은 문자열 형태이다.. <저장 가능한 Value의 길이> + ‘/’ + <하나의 폰북개인에 저장 가능한 해당 Type의 개수 ex) > “TYPEINFO/N” [+ ‘/’ + + ‘:’ < 하나의 폰북개인 “TYPEINFO/TEL 에 저장 가능한 해당 Type parameter의 개수> ] ” 사용예는 다음에 있다. “TYPEINFO” 예 예1) “TYPEINFO/N”을 infoType으로 하여 “10/1”반환 ‘N’ Type에 저장가능한 Value의 길이는 ASCII CHAR 기준 10자 ‘N’ Type은 하나의 폰북개인에 1개 저장 가능 ‘N’ Type에는 Type parameter가 없다. 예2) “TYPEINFO/TEL”을 infoType으로 하여 “15/4/cell:4/work:4/home:4” 반환 ‘TEL’ Type에 저장가능한 Value의 길이는 ASCII CHAR 기준 15자 ‘TEL’ Type은 하나의 폰북개인에 4개 저장 가능 ‘TEL’ Type에는 cell, work, home 3개의 Type parameter가 있다. Type parameter cell, work, home은 하나의 폰북개인에 각각 4개씩 저장 가능. 설명 : 하나의 폰북개인에 집전화, 회사전화, 휴대전화 번호를 통틀어 4개 저 장할 수 있다. 4개 모두를 집전화번호로 설정할 수도 있으며, 4개 모두를 회사전화번 호 또는 휴대전화번호로도 설정할 수 있다. 예3) “TYPEINFO/X-MDAY”를 infoType으로 하여 “10/4/birthday:1/wedding:1/meeting:1/memorial:1/sun:4/moon:4” 반환 ‘X-MDAY’ Type에 저장가능한 Value의 길이는 ASCII CHAR 기준 10자 ‘X-MDAY’ Type은 하나의 폰북개인에 4개 저장 가능 ‘X-MDAY’ Type에는 birthday, wedding, meeting, memorial, sun, moon 6개의 Type parameter가 있다. Type parameter birthday, wedding, meeting, memorial은 하나의 폰북개인에 각 각 1개씩 저장 가능. Type parameter sun, moon은 하나의 폰북개인에 각각 4개씩 저장 가능. 설명 : 하나의 폰북개인에 기념일은 모두 4개 저장할 수 있으며, 생일, 결혼기 념일, 만남, 기념은 각각 하나씩 저장할 수 있다. 따라서 생일, 결혼기념일, 만남, 기 념을 각각 하나씩 저장하여 4개의 기념일을 저장하게 된다. 4개의 기념일 모두 양력 으로 저장하거나 음력으로 저장할 수 있다.

MH_termResGetInfo

프로토타입

M_Int32 MH_termResGetInfo(M_Char* resGroupName, M_Char* resName, M_Char* infoType, M_Byte* infoData, M_Int32 bufSize)

설명

지정한 리소스에 대하여 지정한 정보 타입의 리소스 정보를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름.
resName - [in] 리소스 이름.
infoType - [in] 리소스 정보 타입. (아래 참고 항목에 정의)
infoData - [out] 리소스 정보.
bufSize - [in] infoData 버퍼 크기

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_SHORTBUF - 리소스 정보 버퍼 크기가 작을 경우
M_E_NOTSUPPORTTYPE - 해당 리소스는 지정한 리소스 정보 타입의 리소스 정보를 지원하지 않음
M_E_NOENT - 해당 리소스에, 지정한 리소스 정보 타입의 리소스 정보가 없음

부작용

다음의 참고 항목에 정의된 리소스 포맷에 해당하는 리소스만 지정 가능하다.

참고 항목

‘+’ : 앞뒤 문자열/문자를 strcat 하는 연산을 의미한다. 리소스 포맷은 Terminal Resource 모듈 포팅의 ‘리소스 데이터 포맷 및 MIME 타입’을 따른다.

<표 2-10-13> 리소스 포맷 및 MIME 타입

리소스 포맷 infoTy 비고 pe 이미지 포맷 “WIDTH” 지정한 리소스에 width 정보가 있는 경우 이를 문자열로 반환한다. 단위는 pixel이다. Animation 포맷 “HEIGHT” 지정한 리소스에 height 정보가 있는 경우 이를 동영상 포맷 문자열로 반환한다. 단위는 pixel이다. 동영상 포맷 “RUNTIME” 지정한 리소스에 running time 정보가 있는 경우 이를 문자열로 반환한다. 단위는 ms이다. 사운드 포맷 “BITRATE” 지정한 리소스에 bit rate 정보가 있는 경우 이를 문자열로 반환한다. 단위는 bps(bit per sec)이 다. 동영상 포맷 “FRAMERATE” 지정한 리소스에 frame rate 정보가 있는 경우 이를 문자열로 반환한다. 단위는 fps(frame per sec)이다. BTSINFO 포맷 “MAXCOUNT” 지정한 리소스가 가질 수 있는 최대 정보의 개 수 POWERONOFF 포맷 phonebook/group 포맷 “PRIVATECOU 지정한 폰북그룹에 포함된 폰북개인 수를 문자 NT” 열로 반환한다. 폰북개인이 없는 폰북그룹은 숫 자 0을 반환한다. “PRIVATELIST” 지정한 폰북그룹에 포함된 폰북개인의 리소스 이름 리스트를 반환한다. 반환 형식은 Terminal Resource 모듈 포팅의 ‘리스트 형식’을 따른다. 폰북개인이 없는 폰북그룹은 에러(M_E_NOENT) 를 반환한다.

MH_termResSearch

프로토타입

M_Int32 MH_termResSearch (M_Char* resGroupName, M_Char* queryType, M_Char* queryName, M_Byte* resNames, M_Int32 bufSize,
M_Int32 mode)

설명

리소스 그룹과 검색어 타입에 따라, 주어진 문자열 검색어와 일치하는 리소스를 검색 한다. 검색 결과로 리소스 이름 리스트를 반환한다.

매개 변수

resGroupName - [in] 리소스 그룹 이름.
queryType - [in] 검색어 타입. (아래 참고 항목에 정의)
queryName - [in] 문자열 검색어.
resNames - [out] 리소스 이름 리스트. (Terminal Resource 모듈 포팅의 ‘리스트 형식’을 따른다.)
bufSize - [in] resNames 버퍼 크기
mode - [in] 검색 모드 MH_TERMRES_EXTSRCH queryName 문자열과 정확히 일치하는지를 검색 MH_TERMRES_INCSRCH queryName 문자열을 포함 하는지를 검색

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_SHORTBUF - 반환되는 문자열보다 전달한 버퍼 크기가 작을때 발생
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_NOTSUPPORTTYPE - 해당 리소스 그룹은 지정한 queryType을 지원하지 않음
M_E_NOTFOUND - 검색 결과 리소스가 없음

부작용

다음의 참고 항목에 정의된 queryType에 해당하는 리소스 그룹만 resGroupName으로 지정 가능하다.

참고 항목

<2-10-14> 리소스 그룹 및 질의 타입 리소스 그룹 queryType 비고 모든 리소스 그룹 “UINAME” 지정한 리소스 그룹에서 queryName 문자 열을 가진 UI 이름의 리소스 검색 (UI이름 을 지원하지 않는 리소스 그룹이 있을 수 있음) PHONEBOOK/PRIVATE “NUMBER” 전화번호 검색 : 전화번호에 queryName 문자열을 가진 폰북개인 검색 “PCARD” 사진명함인덱스를 가진 폰북개인 검색. queryName과 mode는 무시한다.

MH_termResExecuteCmd

프로토타입

M_Int32 MH_termResExecuteCmd(M_Char* resGroupName, M_Char* cmd, void* param1, void* param2)

설명

지정한 커맨드에 따라 서비스를 요청한다.

매개 변수

resGroupName - [in] 커맨드를 실행시킬 리소스 그룹 이름
cmd - [in] 서비스 받고자하는 커맨드 (아래 참고 항목에 정의)
param1 - [in/out] 서비스에 대한 인자/반환값 (아래 참고 항목에 정의)
param2 - [in/out] 서비스에 대한 인자/반환값 (아래 참고 항목에 정의)

반환 값

성공

실패

M_E_ERROR - 알 수 없는 이유로 실패
M_E_INVALID - 전달한 매개변수가 잘못되었음
M_E_NOTSUP - 지원되지 않는 커맨드

부작용

없음

참고 항목

지정 가능한 커맨드는 다음과 같으며 차후 추가될 수 있다.