PeerEnumIdentities-Funktion (p2p.h)
Die PeerEnumIdentities-Funktion erstellt und gibt ein Peeraufzählungshandle zurück, das zum Auflisten aller Peeridentitäten verwendet wird, die einem bestimmten Benutzer gehören.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
[out] HPEERENUM *phPeerEnum
);
Parameter
[out] phPeerEnum
Empfängt ein Handle für die Peeraufzählung, die die Liste der Peeridentitäten enthält, wobei jedes Element als Zeiger auf eine PEER_NAME_PAIR-Struktur dargestellt wird. Übergeben Sie dieses Handle an PeerGetNextItem , um die Elemente abzurufen. rufen Sie anschließend PeerEndEnumeration auf, um den Arbeitsspeicher freizugeben.
Rückgabewert
Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
Hinweise
Nachdem die Anwendung das Peeraufzählungshandle abgerufen hat, verwenden Sie PeerGetNextItem und PeerGetItemCount , um die Peeridentitäten aufzulisten.
Beim Auflisten von Peeridentitäten gibt PeerGetNextItem ein Array von Zeigern auf PEER_NAME_PAIR Strukturen zurück.
Rufen Sie PeerEndEnumeration auf, um das Enumerationshandle frei zu geben, wenn es nicht mehr erforderlich ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack für Windows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |