共用方式為

IByteBuffer：：SetSize 方法

  • 發行項

[ SetSize 方法可用於需求一節中指定的作業系統。 它不適用於 Windows Server 2003 service Pack 1 (SP1) 及更新版本、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
標頭
Scardssp.h
類型程式庫
Scardssp.tlb
DLL
Scardssp.dll
IID
 IID_IByteBuffer定義為 E126F8FE-A7AF-11D0-B88A-00C04FD424B9