PeerDistStartup-Funktion (peerdist.h)

  • Artikel

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
ERROR_INVALID_PARAMETER
 Mindestens ein Parameter ist ungültig.
PEERDIST_ERROR_VERSION_UNSUPPORTED
 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

Weitere Informationen

PeerDistShutdown