PeerDistClientOpenContent-Funktion (peerdist.h)

Artikel
08/25/2023

Die Funktion PeerDistClientOpenContent wird geöffnet und gibt eine PEERDIST_CONTENT_HANDLE zurück. Der Client verwendet das Inhaltshandle, um Daten aus dem Peerverteilungsdienst abzurufen.

Syntax

DWORD PeerDistClientOpenContent(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PCPEERDIST_CONTENT_TAG   pContentTag,
  [in, optional] HANDLE                   hCompletionPort,
  [in, optional] ULONG_PTR                ulCompletionKey,
  [out]          PPEERDIST_CONTENT_HANDLE phContentHandle
);

Parameter

[in] hPeerDist

Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

[in] pContentTag

Zeiger auf eine PEERDIST_CONTENT_TAG-Struktur , die einen vom Client angegebenen Bezeichner mit 16 Byte enthält. Dieser Parameter wird in Verbindung mit der Funktion PeerDistClientFlushContent verwendet.

[in, optional] hCompletionPort

Ein Handle für den Vervollständigungsport, der zum Abrufen der Abschlussbenachrichtigung der asynchronen Funktion verwendet werden kann. Verwenden Sie zum Erstellen eines Vervollständigungsports die CreateIoCompletionPort-Funktion Dieser Parameter kann NULL sein.

[in, optional] ulCompletionKey

Der Wert, der über den lpCompletionKey-Parameter der GetQueuedCompletionStatus-Funktion zurückgegeben werden soll. Dieser Parameter wird ignoriert, wenn hCompletionPortNULL ist.

[out] phContentHandle

Ein Zeiger auf eine Variable, die die PEERDIST_CONTENT_HANDLE empfängt, die zum Abrufen oder Hinzufügen von Daten verwendet wird.

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.
ERROR_INVALID_HANDLE	Das hPeerDist-Handle ist ungültig.
ERROR_ACCESS_DISABLED_BY_POLICY	Das Feature wird durch Gruppenrichtlinie deaktiviert.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Der Dienst ist nicht verfügbar.

Hinweise

Der Client muss die PeerDistClientOpenContent-Funktion aufrufen, um ein PEERDIST_CONTENT_HANDLE-Handle abzurufen, das später in den folgenden Funktionen verwendet werden kann:

Wenn ein optionales Vervollständigungsporthandle angegeben wird, wird es zum Veröffentlichen der Vervollständigungsergebnisse der oben aufgeführten asynchronen Funktionen verwendet.

Das vom Funktionsaufruf peerDistClientOpenContent zurückgegebene Handle muss von der Funktion PeerDistClientCloseContent geschlossen werden.

Anforderungen


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