Поделиться через

Функция PeerCollabEnumApplicationRegistrationInfo (p2p.h)

  • Статья

Функция PeerCollabEnumApplicationRegistrationInfo получает дескриптор перечисления, используемый для получения сведений о одноранговом приложении.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

Параметры

[in] registrationType

Значение PEER_APPLICATION_REGISTRATION_TYPE , указывающее, зарегистрировано ли одноранговое приложение для текущего пользователя или всех пользователей компьютера однорангового узла.

[out] phPeerEnum

Указатель на дескриптор перечисления одноранговых узлов для сведений о регистрации однорангового приложения. Эти данные получаются путем передачи этого дескриптора в PeerGetNextItem.

Возвращаемое значение

Возвращает S_OK, если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для поддержки этой операции.
E_INVALIDARG
 Один из аргументов недопустим.
PEER_E_NOT_INITIALIZED
 Одноранговая инфраструктура Windows не инициализирована. Вызов соответствующей функции инициализации является обязательным.

Комментарии

Чтобы получить отдельные одноранговые приложения, передайте возвращенный дескриптор в PeerGetNextItem. Будет возвращен массив PEER_APPLICATION_REGISTRATION_INFO структур. Чтобы закрыть перечисление и освободить связанные с ним ресурсы, передайте этот дескриптор в PeerEndEnumeration. Отдельные элементы, возвращаемые перечислением, должны быть освобождены с помощью PeerFreeData.

Приложение — это набор программного обеспечения или программных функций, доступных в конечной точке однорангового узла. Обычно это относится к пакетам программного обеспечения, поддерживающим одноранговые сетевые действия, такие как игры или другие приложения для совместной работы.

Одноранговое приложение имеет GUID, представляющий отдельное приложение. Когда приложение зарегистрировано для однорангового узла, этот GUID и соответствующее приложение могут быть доступны всем доверенным контактам однорангового узла, что указывает на действия, в которые может участвовать одноранговый узел. Чтобы отменить регистрацию однорангового приложения, вызовите PeerCollabUnregisterApplication с этим GUID.

Элементы сведений о регистрации одноранговых приложений возвращаются в виде отдельных PEER_APPLICATION_REGISTRATION_INFO структур.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2P.lib
DLL P2P.dll

См. также раздел

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

Функции API одноранговой совместной работы

PeerCollabUnregisterApplication