Функция PeerEnumIdentities (p2p.h)
Функция PeerEnumIdentities создает и возвращает дескриптор перечисления одноранговых узлов, используемый для перечисления всех одноранговых удостоверений, принадлежащих конкретному пользователю.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
[out] HPEERENUM *phPeerEnum
);
Параметры
[out] phPeerEnum
Получает дескриптор однорангового перечисления, содержащего список одноранговых удостоверений, каждый элемент которых представлен в виде указателя на структуру PEER_NAME_PAIR . Передайте этот дескриптор в PeerGetNextItem для получения элементов; По завершении вызовите PeerEndEnumeration , чтобы освободить память.
Возвращаемое значение
Если вызов функции выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Один из параметров недопустим. |
|
Недостаточно памяти для выполнения указанной операции. |
Комментарии
Получив дескриптор однорангового перечисления, используйте PeerGetNextItem и PeerGetItemCount для перечисления одноранговых удостоверений.
При перечислении одноранговых удостоверений PeerGetNextItem возвращает массив указателей на PEER_NAME_PAIR структуры.
Вызовите PeerEndEnumeration , чтобы освободить дескриптор перечисления, когда он больше не требуется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения],Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |