Share via


ILockBytes::SetSize 方法 (objidl.h)

SetSize 方法會變更位元組數位的大小。

語法

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

參數

[in] cb

將位元組陣列的新大小指定為位元組數目。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK 位元組數位的大小已成功變更。
STG_E_ACCESSDENIED 呼叫端沒有存取位元組陣列的許可權。
STG_E_MEDIUMFULL 位元組數位大小不會變更,因為儲存裝置上沒有空間。

備註

ILockBytes::SetSize 會變更位元組陣列的大小。 如果 cb 參數大於目前的位元組陣列,則如果搜尋指標超過目前的數據流 結尾,則位元組陣列會填入未定義值的位元組填滿間隔空間,以擴充至指示的大小。

如果 cb 參數小於目前的位元組陣列,位元組陣列會截斷為指定的大小。

來電者的附註

呼叫端無法依賴在適當時間傳回STG_E_MEDIUMFULL,因為操作系統或網路中的快取緩衝。 不過,呼叫端必須能夠處理此傳回碼,因為某些 ILockBytes 實作可能支援它。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

ILockBytes - File-Based 實作

ILockBytes - 全域記憶體實作

ILockBytes::ReadAt

ILockBytes::WriteAt