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
ERROR_SERVICE_DEPENDENCY_FAIL	Der PNRP-Dienst (Peer Name Resolution Protocol) muss gestartet werden, bevor PeerGroupStartup aufgerufen wird.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
PEER_E_IPV6_NOT_INSTALLED	Der Gruppierungsdienst konnte nicht gestartet werden, weil IPv6 nicht auf dem Computer installiert ist.
PEER_E_UNSUPPORTED_VERSION	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

Weitere Informationen

Gruppieren von API-Funktionen

PEER_VERSION_DATA

PeerGroupShutdown