共用方式為

IMFHttpDownloadRequest：：GetTotalLength 方法 (mfidl.h)

  • 發行項

由 Microsoft Media Foundation 叫用，以擷取所下載資源的總長度，如果已知。

語法

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

參數

[out] pqwTotalLength

如果已知，所下載資源的長度總計，以位元組為單位。 如果不知道，請將 設定為 MAX_ULONG (0xFFFFFFFFFFFFFFFF) 。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 已順利完成作業。
E_POINTER
 pqwTotalLength 參數是無效的指標。

備註

只有在成功叫用 EndReceiveResponse 之後，Microsoft Media Foundation 才會叫用 GetTotalLength。 資源的總長度可能大於伺服器在目前回應中傳回的數據量。 例如，如果要求包含 HTTP “Range” 標頭，則響應中傳回的數據可能小於資源的總長度。 GetRangeEndOffset 方法可用來計算目前回應中傳回的數據量。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1703 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mfidl.h
程式庫 Mfplat.lib;Mfplat.dll

另請參閱

IMFHttpDownloadRequest