PeerPnrpGetEndpoint-Funktion (p2p.h)
Die PeerPnrpGetEndpoint-Funktion ruft eine Peerendpunktadresse ab, die während eines asynchronen Vorgangs zur Auflösung von Peernamen aufgelöst wurde.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
[in] HRESOLUTION hResolve,
[out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);
Parameter
[in] hResolve
Das Handle für den asynchronen Vorgang zur Auflösung von Peernamen, der von einem vorherigen Aufruf von PeerPnrpStartResolve zurückgegeben wurde.
[out] ppEndpoint
Zeiger auf die Adresse einer PEER_PNRP_ENDPOINT_INFO-Struktur , die eine Endpunktadresse für den Peernamen enthält, der im vorherigen Aufruf von PeerPnrpStartResolve angegeben wurde.
Diese von diesem Parameter zurückgegebenen Daten müssen durch Aufrufen von PeerFreeData freigegeben werden.
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. |
|
Alle Endpunktadressen wurden für den Peer abgerufen. |
Hinweise
PeerPnrpStartResolve erstellt ein Handle für einen asynchronen Vorgang zur Auflösung von Peernamen.
Wenn ein Endpunkt gefunden wird, wird das in hEvent bereitgestellte Ereignishandle signalisiert, und PeerPnrpGetEndpoint muss mit dem phResolve-Handle von der Anwendung aufgerufen werden, um diesen Endpunkt abzurufen.
Das letzte Ereignis gibt den PEER_E_NO_MORE Fehlercode an, der angibt, dass alle Endpunkte gefunden wurden, die dem peernamen entsprechen, der peerPnrpStartResolve angegeben wurde. Zu diesem Zeitpunkt muss die Anwendung das Handle mit einem Aufruf von PeerPnrpEndResolve schließen.
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) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |