Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die PeerPnrpRegister-Funktion registriert einen Peer bei einer PNRP-Cloud und gibt ein Handle zurück, das für Registrierungsupdates verwendet werden kann.
Hinweis Beim Aufruf wird diese Funktion blockiert, bis der PNRP-Dienst initiiert wurde.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpRegister(
[in] PCWSTR pcwzPeerName,
[in, optional] PPEER_PNRP_REGISTRATION_INFO pRegistrationInfo,
[out] HREGISTRATION *phRegistration
);
Parameter
[in] pcwzPeerName
Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Peernamen enthält, der beim PNRP-Dienst registriert werden soll.
[in, optional] pRegistrationInfo
Zeiger auf eine PEER_PNRP_REGISTRATION_INFO-Struktur , die die Endpunktinformationen für den registrierenden Peerknoten enthält. Bei NULL registriert die API den Peer bei allen bekannten PNRP-Clouds, und alle registrierten Adressen werden automatisch von der Infrastruktur ausgewählt.
[out] phRegistration
Behandeln Sie die PNRP-Registrierung für den aufrufenden Peerknoten. Verwenden Sie dieses Handle, um die Registrierung zu aktualisieren oder die Registrierung beim PNRP-Dienst aufzuheben.
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. |
|
Der lokale Peer verwendet eine Identität, die nicht vorhanden ist. |
Darüber hinaus kann diese Funktion WSA-Werte zurückgeben. Eine vollständige Liste der möglichen Werte finden Sie unter PNRP NSP-Fehlercodes.
Hinweise
Ein Handle muss in einem Prozess registriert werden, der von dem Prozess getrennt ist, in dem es aufgelöst wird. Wenn ein Handle innerhalb desselben Prozesses registriert und aufgelöst wird, wird es nicht erkannt.
Ein Name kann nicht mehr als einmal bei einem Endpunkt registriert werden. Wenn Updates für einen registrierten Namen erforderlich sind, verwenden Sie PeerPnrpUpdateRegistration.
Wenn pRegistrationInfoNULL ist oder PEER_PNRP_AUTO_ADDRESSES für cAddresses angegeben ist, hält die Infrastruktur die registrierten Adressen auf dem neuesten Stand, wenn sich Adressen ändern oder sich die Cloudverfügbarkeit ändert.
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 |