WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 운영 체제: Linux, Windows

ObjectMessage

오브젝트 메시지는 본문이 직렬화된 Java 또는 .NET 오브젝트를 구성하는 메시지입니다.

상속 계층 구조:
xms::PropertyContext
   |
   +----xms::Message
           |
           +----xms::ObjectMessage
관련 참조
오브젝트 메시지

메소드

메소드 요약:
메소드 설명
getObject 오브젝트 메시지의 본문을 구성하는 오브젝트를 가져옵니다.
setObject 오브젝트 메시지의 본문을 구성하는 문자열을 설정합니다.

getObject – 바이트로 오브젝트 가져오기

인터페이스:
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
참고:
  1. 버퍼가 전체 오브젝트를 저장할 정도로 크지 않을 경우 XMS 버퍼의 길이로 잘려진 오브젝트를 리턴하고, actualLength 매개변수를 전체 오브젝트의 실제 길이로 설정하며, 오류 코드 XMS_E_DATA_TRUNCATED를 리턴합니다.
  2. 오브젝트를 가져오려는 중에 어떤 다른 오류가 발생한 경우 XMS 오류를 보고하지만 actualLength 매개변수는 설정하지 않습니다.

setObject – 바이트로 오브젝트 설정

인터페이스:
xmsVOID setObject(xmsSBYTE *value,
                  xmsINT length);

오브젝트 메시지의 본문을 구성하는 문자열을 설정합니다.

매개변수:
value(입력)
설정할 오브젝트를 표시하는 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_WRITABLE_EXCEPTION

상속된 메소드


Reference topic

이용약관 | 피드백

Timestamp icon마지막 갱신 날짜: 3 Mar 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
이 Information Center는 Eclipse 기술 기반입니다. (http://www.eclipse.org 웹 사이트 참조)