PeerDistClientOpenContent 函式 (peerdist.h)

發行項
08/25/2023

PeerDistClientOpenContent函式隨即開啟，並傳回PEERDIST_CONTENT_HANDLE。用戶端會使用內容控制碼從對等散發服務擷取資料。

語法

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

參數

[in] hPeerDist

PeerDistStartup傳回的PEERDIST_INSTANCE_HANDLE。

[in] pContentTag

包含 16 位元組用戶端指定識別碼之PEERDIST_CONTENT_TAG 結構的指標。此參數會與 PeerDistClientFlushContent 函式搭配使用。

[in, optional] hCompletionPort

可用於擷取非同步函式完成通知之完成埠的控制碼。若要建立完成埠，請使用 CreateIoCompletionPort 函式：此參數可以是 Null。

[in, optional] ulCompletionKey

要透過GetQueuedCompletionStatus函式的lpCompletionKey參數傳回的值。 當 hCompletionPort為Null時，會忽略此參數。

[out] phContentHandle

接收用來擷取或新增資料 之PEERDIST_CONTENT_HANDLE 變數的指標。

傳回值

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

傳回碼	描述
ERROR_INVALID_PARAMETER	一或多個參數無效。
ERROR_INVALID_HANDLE	hPeerDist控制碼無效。
ERROR_ACCESS_DISABLED_BY_POLICY	群組原則會停用此功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE	服務無法使用。

備註

用戶端必須呼叫 PeerDistClientOpenContent 函式，以取得稍後可在下列函式中使用的 PEERDIST_CONTENT_HANDLE 控制碼：

如果指定選擇性的完成埠控制碼，則會用於張貼上述所列非同步函式的完成結果。

PeerDistClientOpenContent函式呼叫所傳回的控制碼必須由PeerDistClientCloseContent函式關閉。

需求


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