PeerPnrpResolve-Funktion (p2p.h)
Die PeerPnrpResolve-Funktion ruft die Endpunktadresse(en) ab, die für einen bestimmten Peernamen registriert sind.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpResolve(
[in] PCWSTR pcwzPeerName,
[in, optional] PCWSTR pcwzCloudName,
[in, out] ULONG *pcEndpoints,
[out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoints
);
Parameter
[in] pcwzPeerName
Zeiger auf eine Zeichenfolge mit Null, die den Peernamen enthält, für den Endpunktadressen abgerufen werden.
[in, optional] pcwzCloudName
Zeiger auf eine null beendete Zeichenfolge, die den Namen der PNRP-Cloud enthält, unter der der Peername aufgelöst werden soll. Wenn NULL, wird die Auflösung in allen Clouds ausgeführt. Wenn PEER_PNRP_ALL_LINK_CLOUDS, wird die Auflösung in allen lokalen Linkwolken ausgeführt. Wenn "GLOBAL_", erfolgt die Auflösung nur in der globalen Cloud.
[in, out] pcEndpoints
Die maximale Anzahl von Endpunkten, die in ppEndpoints zurückgegeben werden sollen. Nach der Rückgabe enthält dieser Parameter die tatsächliche Anzahl von Endpunkten in ppEndpoints.
[out] ppEndpoints
Zeiger auf eine Liste von PEER_PNRP_ENDPOINT_INFO Strukturen, die die Endpunkte enthalten, für die der Peername erfolgreich aufgelöst wurde. Jeder Endpunkt enthält mindestens eine IP-Adresse, unter der der Peerknoten erreicht werden kann.
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
Dieser Aufruf ist synchron und wird blockiert, bis er abgeschlossen ist. Rufen Sie für die asynchrone Peernamenauflösung PeerPnrpStartResolve auf, und rufen Sie die aufgelöste Endpunktadresse ab, wenn das angegebene Ereignis ausgelöst wird.
Ein Handle muss in einem Prozess aufgelöst werden, der von dem Prozess getrennt ist, in dem es registriert wurde. Wenn ein Handle innerhalb desselben Prozesses registriert und aufgelöst wird, wird es nicht erkannt.
Wenn die Auflösung für alle Clouds durchgeführt wird, wird sie gleichzeitig für jede Cloud ausgegeben. Die Methode wird zurückgegeben, sobald sie genügend Ergebnisse aus einer Beliebigen Kombination von Clouds erhalten hat.
Das standardmäßige Auflösungstimeout, das intern von dieser Methode verwendet wird, beträgt 30 Sekunden. Wenn ein bestimmtes Timeout erforderlich ist, sollte die asynchrone PeerPnrpStartResolve-Funktion verwendet werden.
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 |