Функция PeerGroupGetProperties (p2p.h)
Функция PeerGroupGetProperties извлекает сведения о свойствах указанной группы.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetProperties(
[in] HGROUP hGroup,
[out] PPEER_GROUP_PROPERTIES *ppProperties
);
Параметры
[in] hGroup
Обработка одноранговой группы, свойства которой извлекаются. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.
[out] ppProperties
Указатель на структуру PEER_GROUP_PROPERTIES , содержащую сведения о свойствах одноранговой группы. Эти данные должны быть освобождены с помощью PeerFreeData. Это обязательный параметр.
Возвращаемое значение
Возвращает S_OK , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
Код возврата | Описание |
---|---|
|
Один из параметров недопустим. |
|
Недостаточно памяти для выполнения указанной операции. |
|
Группа не находится в состоянии, в котором можно получить свойства одноранговой группы. Например, вызывается PeerGroupJoin , но синхронизация с базой данных группы не завершена. |
|
Дескриптор одноранговой группы недопустим. |
Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.
Комментарии
Невозможно получить свойства группы, если одноранговый узел не синхронизирован с базой данных одноранговой группы. Чтобы синхронизироваться с базой данных одноранговой группы перед вызовом этой функции, сначала вызовите PeerGroupConnect.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
Минимальная версия сервера | Ни одна версия не поддерживается |
Целевая платформа | Windows |
Header | p2p.h |
Библиотека | P2P.lib |
DLL | P2P.dll |