跳轉到主要內容
此方法於用戶端實作,用於從自訂來源輸入待處理的資料。您實作此方法時,應建立資料陣列,並將其交由呼叫端接管;呼叫端之後必須負責在使用完畢後釋放其記憶體。

語法

C++

HRESULT Read(
  SAFEARRAY(BYTE)* Data,
  int              Count,
  int*             BytesRead
);

C#

int Read(
  out byte[] Data,
  int        Count
);

Visual Basic .NET

Function Read( _
  ByRef Data() As Byte, _
  ByVal Count As Integer _
) As Integer

參數

Data [out] 此參數表示要讀取的資料。此方法的實作應建立此陣列,並將所需資料寫入其中。不再需要時,呼叫端必須負責釋放這塊記憶體。 Count [in] 此參數指定要讀取的位元組數上限。 BytesRead [out, retval] 此參數指定實際讀取的位元組數 (也就是 Data 緩衝區佔用的記憶體大小) 。如果此數值大於 0,系統會再次呼叫此方法,直到此參數傳回 0 為止。

回傳值

[僅限 C++] 如果此方法的回傳值不是 S_OK,則表示用戶端發生錯誤。

備註

方法 的用戶端實作必須確保,在 方法 內部擲出的所有例外狀況都會被捕捉並處理,且不會傳遞到 方法 外部。若例外狀況傳遞到 方法 外部,可能會導致不可預期的結果 (例如程式終止) 。

另請參閱

IReadStream