ISequentialStream：：Write 方法 (objidl.h)

Write 方法會將指定的位元組數寫入資料流物件，從目前的搜尋指標開始。

語法

HRESULT Write(
  [in]  const void *pv,
  [in]  ULONG      cb,
  [out] ULONG      *pcbWritten
);

[in] pv

緩衝區的指標，其中包含要寫入數據流的數據。即使 cb 為零，也必須為此參數提供有效的指標。

[in] cb

要嘗試寫入數據流的數據位元組數目。此值可以是零。

[out] pcbWritten

ULONG 變數的指標，此方法會將寫入數據流物件的實際位元元組數目寫入其中。呼叫端可以將這個指標設定為 NULL，在此情況下，此方法不會提供寫入的實際位元組數目。

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

傳回碼	描述
S_OK	數據已成功寫入數據流物件。
E_PENDING	僅限異步記憶體：目前無法使用要寫入的部分或所有數據。
STG_E_MEDIUMFULL	寫入作業失敗，因為儲存裝置上沒有剩餘的空間。
STG_E_ACCESSDENIED	呼叫端沒有寫入這個數據流物件的必要許可權。
STG_E_CANTSAVE	因為存取不正確或空間不足以外的原因，無法寫入數據。
STG_E_INVALIDPOINTER	其中一個指標值無效。 pv 參數必須包含有效的指標，即使 cb 為零也一樣。
STG_E_REVERTED	物件已因交易樹狀結構中上方的還原作業而失效。
STG_E_WRITEFAULT	寫入作業因磁碟錯誤而失敗。當此方法嘗試使用 STGM_SIMPLE 旗標) ，以簡單 (模式開啟的數據流時，也會傳回這個值。

ISequentialStream：：Write 會將指定的數據寫入數據流物件。搜尋指標會針對實際寫入的位元元組數目進行調整。實際寫入的位元組數目會傳回 於 wwwWritten 參數中。如果位元組計數為零位元組，寫入作業就不會有任何作用。

如果搜尋指標目前超過數據流結尾，且位元組計數為非零，這個方法會將數據流的大小增加至搜尋指標，並寫入從搜尋指標開始的指定位元組。寫入數據流的填滿位元組不會初始化為任何特定值。這與 MS-DOS FAT 檔案系統中的檔案結束行為相同。

在零位元組計數和超過數據流結尾的搜尋指標時，這個方法不會建立填滿位元組，以將數據流增加至搜尋指標。在此情況下，您必須呼叫 IStream：：SetSize 方法來增加數據流的大小，並寫入填滿位元組。

即使發生錯誤， 也可能會有一 個值。

在 COM 提供的實作中，數據流物件不是疏鬆的。任何填滿位元組最終會在磁碟上配置，並指派給數據流。

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