PeerCollabEnumApplications-Funktion (p2p.h)
Die PeerCollabEnumApplications-Funktion gibt das Handle an eine Enumeration zurück, die die Anwendungen enthält, die bei den Endpunkten eines bestimmten Peers registriert sind.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
Parameter
[in, optional] pcEndpoint
Zeiger auf eine PEER_ENDPOINT Struktur, die die Endpunktinformationen für einen Peer enthält, dessen Anwendungen aufgelistet werden.
Wenn dieser Parameter auf NULL festgelegt ist, werden die veröffentlichten Anwendungsinformationen für den Endpunkt des lokalen Peers aufgelistet.
[in, optional] pApplicationId
Zeiger auf den GUID-Wert, der eine bestimmte Anwendung des angegebenen Peers eindeutig identifiziert. Wenn dieser Parameter angegeben wird, wird nur die Peeranwendung zurückgegeben, die dieser GUID entspricht.
[out] phPeerEnum
Zeiger auf das Handle für den aufgezählten Satz registrierter Anwendungen, die der in pObjectId zurückgegebenen GUID entsprechen. Übergeben Sie dieses Handle an PeerGetNextItem , um jedes Element im aufgezählten Satz abzurufen.
Rückgabewert
Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang zu unterstützen. |
|
Eines der Argumente ist ungültig. |
|
Die Windows-Peer-Infrastruktur wird nicht initialisiert. Das Aufrufen der entsprechenden Initialisierungsfunktion ist erforderlich. |
Hinweise
Um die Anwendungen für den angegebenen Endpunkt erfolgreich aufzulisten, müssen Anwendungsdaten auf dem Endpunkt verfügbar sein. Damit Anwendungsdaten verfügbar sind, muss eine der folgenden Schritte erfolgen:
- Der Endpunkt muss zuvor durch Aufrufen von PeerCollabEnumEndpoints abgerufen worden sein.
- Der lokale Peer muss den Endpunkt durch Aufrufen von PeerCollabSubscribeEndpointData abonniert haben.
- Die Endpunktdaten müssen aktualisiert werden, indem PeerCollabRefreshEndpointData erfolgreich aufgerufen wird.
Um die einzelnen Peeranwendungen abzurufen, übergeben Sie das zurückgegebene Handle an PeerGetNextItem. Um die Enumeration zu schließen und die zugeordneten Ressourcen freizugeben, übergeben Sie dieses Handle an PeerEndEnumeration. Einzelne von der Enumeration zurückgegebene Elemente müssen mit PeerFreeData freigegeben werden.
Peeranwendungsdatenelemente werden als einzelne PEER_APPLICATION-Strukturen zurückgegeben.
Die PeerCollabEnumApplications-Funktion gibt ein leeres Array für Endpunkte im Subnetz zurück, die keine vertrauenswürdigen Kontakte sind.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |