共用方式為

PeerDistServerRetrieveContentInformation 函式 (peerdist.h)

  • 發行項

PeerDistServerRetrieveContentInformation 函式會擷取與 PeerDistServerOpenContentInformation 所傳回之句柄相關聯的編碼內容資訊。

語法

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

參數

[in] hPeerDist

PeerDistStartup 傳回的PEERDIST_INSTANCE_HANDLE。

[in] hContentInfo

PeerDistServerOpenContentInformation 所傳回的句柄。

cbMaxNumberOfBytes

要讀取的最大位元組數。

[in, out] pBuffer

接收內容信息數據的緩衝區指標。

[in] lpOverlapped

重疊結構的指標。 此函式不允許呼叫端在內容中指定開始 Offset。 位移會隱含地維護每個 hContentInfo。 Offset 和 OffsetHigh 是保留的，而且必須是零。

傳回值

如果函式成功，傳回值 會ERROR_IO_PENDING。 否則，此函式可能會傳回下列其中一個值：

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_INVALID_HANDLE
 hPeerDist 或 hContentInfo 句柄無效。
PEERDIST_ERROR_NO_MORE
 已觸達內容資訊的 EOF。
ERROR_ACCESS_DISABLED_BY_POLICY
 群組原則 會停用此功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服務無法使用。

備註

在 PeerDistServerRetrieveContentInformation 作業成功時，會填入所擷取內容資訊中的 ULONGLONG 位移和OffsetHigh 字段。 OffsetHigh 成員會設定為位移較高的 32 位，而 Offset 成員會設定為位移的較低 32 位。

GetOverlappedResult 會將傳輸的位元元組數目填入 lpNumberOfBytesTransferred 。 如果呼叫端使用完成埠來處理對等散發 API 完成，GetQueuedCompletionStatus 的 lpNumberOfBytes 自變數將會填入傳輸的位元元數目。

規格需求

需求 值
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 peerdist.h
程式庫 PeerDist.lib
Dll PeerDist.dll

另請參閱

PeerDistServerOpenContentInformation

PeerDistStartup