IByteBuffer::SetSize 메서드
[ SetSize 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. IStream 인터페이스는 비슷한 기능을 제공합니다.]
SetSize 메서드는 스트림 개체의 크기를 변경합니다.
구문
HRESULT SetSize(
[in] LONG libNewSize
);
매개 변수
-
libNewSize [in]
-
스트림의 새 크기(바이트 수)
반환 값
반환 값은 HRESULT입니다. S_OK 값은 호출이 성공했음을 나타냅니다.
설명
IByteBuffer::SetSize 메서드는 스트림 개체의 크기를 변경합니다. 스트림의 공간을 미리 할당하려면 이 메서드를 호출합니다. libNewSize 매개 변수가 현재 스트림 크기보다 큰 경우 스트림은 중간 공간을 정의되지 않은 값의 바이트로 채워 표시된 크기로 확장됩니다. 이 작업은 검색 포인터가 현재 스트림 끝을 지나면 IByteBuffer::Write 메서드와 유사합니다.
libNewSize 매개 변수가 현재 스트림보다 작으면 스트림이 표시된 크기로 잘립니다.
검색 포인터는 스트림 크기 변경의 영향을 받지 않습니다.
IByteBuffer::SetSize를 호출하는 것은 연속된 공간의 큰 청크를 가져오는 효과적인 방법이 될 수 있습니다.
예제
다음 예제에서는 버퍼 크기를 설정하는 방법을 보여줍니다.
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 클라이언트 지원 종료 |
Windows XP |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_IByteBuffer E126F8FE-A7AF-11D0-B88A-00C04FD424B9로 정의됩니다. |