peerDistStartup 函式 (peerdist.h)

  • 發行項

PeerDistStartup 函式會建立新的對等散發實例句柄，該句柄必須傳遞至所有其他對等散發 API。

語法

DWORD PeerDistStartup(
  [in]            DWORD                     dwVersionRequested,
  [out]           PPEERDIST_INSTANCE_HANDLE phPeerDist,
  [out, optional] PDWORD                    pdwSupportedVersion
);

參數

[in] dwVersionRequested

包含應用程式要求之對等散發的最低版本。 高序位元組會指定次要版本號碼;低順序位元組會指定主要版本號碼。

[out] phPeerDist

PEERDIST_INSTANCE_HANDLE變數的指標，成功時會收到新建立的句柄。

[out, optional] pdwSupportedVersion

變數的指標，如果不是 NULL，則包含對等散發系統所支援的最大版本號碼。 高序位元組會指定次要版本號碼;低順序位元組會指定主要版本號碼。

傳回值

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

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
PEERDIST_ERROR_VERSION_UNSUPPORTED
 用戶端 DLL 不支援要求的版本。

備註

在任何其他對等散發函式之前，必須先呼叫PeerDistStartup。 不再需要時，應該透過對PeerDistShutdown的呼叫來關閉PeerDistStartup傳回的句柄。

規格需求

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

另請參閱

PeerDistShutdown