다음을 통해 공유


ILockBytes::SetSize 메서드(objidl.h)

SetSize 메서드는 바이트 배열의 크기를 변경합니다.

구문

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

매개 변수

[in] cb

바이트 배열의 새 크기를 바이트 수로 지정합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
S_OK 바이트 배열의 크기가 변경되었습니다.
STG_E_ACCESSDENIED 호출자에게 바이트 배열에 액세스할 수 있는 권한이 없습니다.
STG_E_MEDIUMFULL 스토리지 디바이스에 남은 공간이 없으므로 바이트 배열 크기는 변경되지 않습니다.

설명

ILockBytes::SetSize 는 바이트 배열의 크기를 변경합니다. cb 매개 변수가 현재 바이트 배열보다 큰 경우 검색 포인터가 현재 스트림 끝을 지나면 바이트 배열이 ILockBytes::WriteAt와 마찬가지로 중간 공간을 정의되지 않은 값의 바이트로 채워 표시된 크기로 확장됩니다.

cb 매개 변수가 현재 바이트 배열보다 작으면 바이트 배열이 표시된 크기로 잘립니다.

발신자에게 참고 사항

호출자는 운영 체제 또는 네트워크의 캐시 버퍼링으로 인해 적절한 시간에 반환되는 STG_E_MEDIUMFULL 사용할 수 없습니다. 그러나 일부 ILockBytes 구현이 이를 지원할 수 있으므로 호출자는 이 반환 코드를 처리할 수 있어야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 objidl.h
라이브러리 Uuid.lib
DLL Ole32.dll

추가 정보

ILockBytes - File-Based 구현

ILockBytes - 전역 메모리 구현

ILockBytes::ReadAt

ILockBytes::WriteAt