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 |