dsmGetBufferData
dsmGetBufferData 함수 호출은 버퍼를 통해 IBM® Storage Protect 에서 데이터의 바이트 스트림을 수신합니다. 각각의 호출 후 애플리케이션은 데이터를 복사하고 dsmReleaseBuffer에 대한 호출을 통해 버퍼를 해제해야 합니다. 애플리케이션이 보유한 버퍼 수가 dsmInitEx 호출에 지정된 numTsmBuffers와 동일한 경우 dsmGetBufferData 함수는 dsmReleaseBuffer가 호출될 때까지 차단됩니다.
구문
dsInt16_t dsmGetBufferData (getDatatExIn_t *dsmGetBufferDataExInP,
getDataExOut_t *dsmGetBufferDataExOutP) ;
매개변수
- getDataExIn_t * dsmGetBufferDataExInP (I)
- 이 구조에는 다음 입력 매개변수가 포함되어 있습니다.
- dsUint32_t dsmHandle
- 세션을 식별하여 이전의 dsmInitEx 호출과 연관시키는 핸들입니다.
- getDataExOut_t * dsmGetBufferDataExOutP (0)
- 이 구조에는 다음 출력 매개변수가 포함되어 있습니다.
- dsUint8_t tsmBufferHandle(0)
- 수신된 버퍼를 식별하는 핸들입니다.
- char *dataPtr(0)
- 데이터가 기록된 주소입니다.
- dsUint32_t numBytes(0)
- IBM Storage Protect가 쓴 실제 바이트 수입니다.
리턴 코드
리턴 코드 번호는 괄호 ( ) 안에 표시됩니다.
| 리턴 코드 | 설명 |
|---|---|
| DSM_RC_BAD_CALL_SEQUENCE (2041) | 호출이 적절한 상태에서 발행되지 않았습니다. |
| DSM_RC_OBJ_ENCRYPTED (2049) | 이 함수는 암호화된 오브젝트에 사용할 수 없습니다. |
| DSM_RC_OBJ_COMPRESSED (2048) | 이 함수는 압축된 오브젝트에 사용할 수 없습니다. |
| DSM_RC_BUFF_ARRAY_ERROR (2045) | 버퍼 배열 오류가 발생했습니다. |