PeerDistStartup-Funktion (peerdist.h)
Die PeerDistStartup-Funktion erstellt ein neues Peerverteilungs-instance-Handle, das an alle anderen Peerverteilungs-APIs übergeben werden muss.
Syntax
DWORD PeerDistStartup(
[in] DWORD dwVersionRequested,
[out] PPEERDIST_INSTANCE_HANDLE phPeerDist,
[out, optional] PDWORD pdwSupportedVersion
);
Parameter
[in] dwVersionRequested
Enthält die Von der Anwendung angeforderte Mindestversion der Peerverteilung. Das Byte mit hoher Reihenfolge gibt die Nebenversionsnummer an. Das Byte der niedrigen Reihenfolge gibt die Hauptversionsnummer an.
[out] phPeerDist
Ein Zeiger auf eine PEERDIST_INSTANCE_HANDLE Variable, die bei Erfolg ein neu erstelltes Handle empfängt.
[out, optional] pdwSupportedVersion
Ein Zeiger auf eine Variable, die, wenn nicht NULL, die maximale Versionsnummer enthält, die vom Peerverteilungssystem unterstützt wird. Das Byte mit hoher Reihenfolge gibt die Nebenversionsnummer an. Das Byte der niedrigen Reihenfolge gibt die Hauptversionsnummer an.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Andernfalls gibt die Funktion möglicherweise einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens ein Parameter ist ungültig. |
|
Die angeforderte Version wird von clientseitiger DLL nicht unterstützt. |
Hinweise
PeerDistStartup muss vor allen anderen Peerverteilungsfunktionen aufgerufen werden. Wenn es nicht mehr benötigt wird, sollte das von PeerDistStartup zurückgegebene Handle über einen Aufruf von PeerDistShutdown geschlossen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | peerdist.h |
| Bibliothek | PeerDist.lib |
| DLL | PeerDist.dll |