PeerGroupStartup-Funktion (p2p.h)
Die PeerGroupStartup-Funktion initiiert eine Peergruppe mithilfe einer angeforderten Version der Peerinfrastruktur.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
[in] WORD wVersionRequested,
[out] PPEER_VERSION_DATA pVersionData
);
Parameter
[in] wVersionRequested
Gibt die höchste Version der Peerinfrastruktur an, die ein Aufrufer unterstützen kann. Das Byte mit hoher Reihenfolge gibt die Nummer der Nebenversion (Revision) an. Das Byte in niedriger Reihenfolge gibt die Hauptversionsnummer an. Dieser Parameter ist erforderlich.
[out] pVersionData
Zeiger auf eine PEER_VERSION_DATA-Struktur , die die spezifische Unterstützungsebene der Peerinfrastruktur enthält. Dieser Parameter ist erforderlich.
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 |
|---|---|
|
Der PNRP-Dienst (Peer Name Resolution Protocol) muss gestartet werden, bevor PeerGroupStartup aufgerufen wird. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
|
Der Gruppierungsdienst konnte nicht gestartet werden, weil IPv6 nicht auf dem Computer installiert ist. |
|
Die angeforderte Version wird vom installierten Peersubsystem nicht unterstützt. |
Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.
Hinweise
Der PNRP-Dienst (Peer Name Resolution Protocol) muss vor dem Aufrufen dieser Funktion gestartet werden.
Diese Funktion wird von der Anwendung aufgerufen, bevor eine andere Peergruppierungsfunktion aufgerufen wird.
Für dieses Release sollten Anwendungen PEER_GROUP_VERSION als angeforderte Version verwenden.
Eine Peergruppe, die mit dieser Funktion gestartet wird, wird durch Aufrufen von PeerGroupShutdown geschlossen, wenn die Anwendung beendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |