Функция 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. В противном случае функция может вернуть одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
Один или несколько параметров являются недопустимыми. |
|
Запрошенная версия не поддерживается библиотекой DLL на стороне клиента. |
Комментарии
Метод PeerDistStartup должен вызываться перед любыми другими функциями однорангового распределения. Если дескриптор, возвращаемый PeerDistStartup , больше не нужен, должен быть закрыт с помощью вызова PeerDistShutdown.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | peerdist.h |
| Библиотека | PeerDist.lib |
| DLL | PeerDist.dll |