odm_err_msg 서브루틴

온라인 편집

용도

오류 메시지 문자열을 리턴합니다.

라이브러리

개체 데이터 관리자 라이브러리libodm.a

구문

#include <odmi.h>
int odm_err_msg ( ODMErrno,  MessageString)
long ODMErrno;
char **MessageString;

설명

Odm_err_msg 서브루틴은 입력 ODM 오류 번호에 해당하는 메시지 문자열의 문자열 포인터를 넣을 주소와 ODMErrno 매개 변수를 입력으로 받습니다. 입력 오류 번호에 해당하는 메시지를 찾을 수 없는 경우 널 문자열이 리턴되고 서브루틴은 실패합니다.

매개변수

항목 설명
ODMErrno 메시지 문자열이 검색되는 오류 코드를 지정합니다.
MessageString 리턴된 오류 메시지 문자열을 가리키는 문자열 포인터의 주소를 지정합니다.

리턴 값

성공적인 완료 시 0 값이 리턴됩니다. Odm_err_msg 서브루틴이 실패하면 -1 값이 반환되고 반환되는 MessageString 값은 null 문자열입니다.

예

다음 예는 odm_err_msg 서브루틴의 사용법을 보여줍니다:

#include <odmi.h>
char *error_message;

...
/*--------------------------------------------------------------*/
/*ODMErrno was returned from a previous ODM subroutine call.*/
/*--------------------------------------------------------------*/
returnstatus = odm_err_msg ( odmerrno, &error_message );
if ( returnstatus < 0 )
   printf ( "Retrieval of error message failed\n" );
else
   printf ( error_message );