IChannel::ReadBin

입력 채널로부터 바이너리 데이터를 읽습니다.

virtual GSErrCode ReadBin (
    char *              destination,
    USize               nOfCharToRead,
    USize *             read = NULL
) = 0;

파라미터

destination

바이너리 데이터를 수신하는 목적지 버퍼입니다.

nOfCharToRead

목적지 버퍼로 읽어들이는 문자들의 개수입니다.

read

리턴시: 만약 NULL이 아닐 경우 입력 채널로부터 성공적으로 읽어들인 문자들의 개수입니다.

리턴 값

값	의미
NoError*	OK
EndOfInput*	입력의 끝에 도달했습니다. 동작이 완료되지 않았습니다.
ReadError*	입력 디바이스 상에서 읽기 오류가 발생했습니다. 동작이 완료되지 않았습니다.
Error*	불특정 오류입니다.

^* IChannel 클래스 범위 안에 선언됨
^* GS 네임스페이스 안에 선언됨, 그러나 글로벌 범위에서 접근 가능함

설명

이 메소드는 입력 채널로부터 바이너리 데이터를 읽습니다. 이것은 목적지 버퍼로 지정한 개수의 문자들을 읽어옵니다. 이 문자들은 소비됩니다. 즉, 입력 채널로부터 제거됩니다.
만약 입력 채널 상에 충분한 데이터가 남아 있지 않을 경우 EndOfInput이 리턴됩니다. 이 경우 출력 read 파라미터는 성공적으로 읽어들인 문자들의 개수를 포함하고 있습니다.
입력 상태는 기록하고 입력 채널 상에서 1번째로 발생한 오류를 저장할 것입니다. 오류가 발생한 후에 이 메소드는 아무 것도 하지 않으며 즉시 저장된 오류 코드를 리턴합니다. (입력 상태가 사용자에 의해 리셋될 때까지)

참고사항

GetInputStatus | ResetInputStatus