이 주제은 값으로 바이트 배열을 리턴하는 C 함수에 사용되는 인터페이스를 설명합니다.
xmsRC xmsGetByteArrayProperty(xmsHObj object xmsCHAR *propertyName, xmsSBYTE *propertyValue, xmsINT length, xmsINT *actualLength xmsHErrorBlock errorBlock) const;
버퍼가 전체 배열을 저장할 정도로 크지 않을 경우 XMS 버퍼의 길이로 잘려진 배열을 리턴하고, actualLength 매개변수를 전체 배열의 길이로 설정하며, 오류 코드 XMS_E_DATA_TRUNCATED를 리턴합니다.
두 개의 함수인 xmsBytesMsgReadBytes() 및 xmsStreamMsgReadBytes()의 인터페이스가 약간씩 다릅니다. 이러한 함수 중 하나를 사용하여 응용프로그램은 함수를 연속 호출해서 각 단계에서 바이트 배열을 검색할 수 있습니다. 각 호출은 내부 커서의 현재 위치에서 시작된 응용프로그램이 제공하는 버퍼로 바이트를 읽어 넣으며 출력 매개변수인 returnedLength는 버퍼로 읽어 넣는 바이트 수를 응용프로그램에 알려 줍니다. 두 함수 모두 인터페이스에 actualLength와 동등한 매개변수를 갖지 않지만 응용프로그램이 현재 커서 위치부터 시작하여 배열에 남은 바이트 수를 판별하기 위해 XMSC_QUERY_SIZE를 지정할 수 있습니다.