- 인터페이스:
-
xmsINT getObject(xmsSBYTE *buffer,
xmsINT bufferLength,
xmsINT *actualLength);
오브젝트 메시지의 본문을 구성하는 오브젝트를 가져옵니다.
이 메소드의 사용 방법에 대한 자세한 정보는
바이트 배열을 리턴하는 C++ 메소드를 참조하십시오.
- 매개변수:
- buffer(출력)
- 바이트 배열로 리턴되는 오브젝트를 포함하는 버퍼입니다.
- bufferLength(입력)
- 버퍼 길이(바이트)입니다. XMSC_QUERY_SIZE를 지정한 경우
오브젝트는 리턴되지 않고 actualLength 매개변수로 길이가 리턴됩니다.
- actualLength(출력)
- 오브젝트 길이(바이트)입니다. 입력에서 널 포인트를
지정한 경우 길이가 리턴되지 않습니다.
- 리턴값:
- 오브젝트 길이(바이트)입니다.
- 예외:
-
- XMS_X_GENERAL_EXCEPTION
- XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
- XMS_X_MESSAGE_EOF_EXCEPTION
참고: - 버퍼가 전체 오브젝트를 저장할 정도로 크지 않을 경우
XMS 버퍼의 길이로 잘려진
오브젝트를 리턴하고, actualLength 매개변수를 전체 오브젝트의 실제 길이로 설정하며, 오류 코드
XMS_E_DATA_TRUNCATED를 리턴합니다.
- 오브젝트를 가져오려는 중에 어떤 다른 오류가 발생한 경우
XMS
오류를 보고하지만 actualLength 매개변수는 설정하지 않습니다.