PeerDistServerOpenContentInformation-Funktion (peerdist.h)

  • Artikel

Die Funktion PeerDistServerOpenContentInformation öffnet eine PEERDIST_CONTENTINFO_HANDLE. Der Client verwendet das Handle, um Inhaltsinformationen abzurufen.

Syntax

DWORD PeerDistServerOpenContentInformation(
  [in]           PEERDIST_INSTANCE_HANDLE     hPeerDist,
                 DWORD                        cbContentIdentifier,
  [in]           PBYTE                        pContentIdentifier,
                 ULONGLONG                    ullContentOffset,
                 ULONGLONG                    cbContentLength,
  [in, optional] HANDLE                       hCompletionPort,
  [in, optional] ULONG_PTR                    ulCompletionKey,
  [out]          PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);

Parameter

[in] hPeerDist

Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

cbContentIdentifier

Die Länge des Inhaltsbezeichners in Bytes.

[in] pContentIdentifier

Zeiger auf einen Puffer, der den Inhaltsbezeichner enthält.

ullContentOffset

Ein Offset vom Anfang des veröffentlichten Inhalts, für den das Inhaltsinformationshandle angefordert wird.

cbContentLength

Die Länge des Inhalts (beginnend mit ullContentOffset) in Bytes, für den die Inhaltsinformationen angefordert werden.

[in, optional] hCompletionPort

Ein Handle für den Vervollständigungsport, der zum Abrufen der Abschlussbenachrichtigung der asynchronen Funktion verwendet wird. Verwenden Sie zum Erstellen eines Abschlussports die Funktion CreateIoCompletionPort. 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] phContentInfo

Ein Handle, das zum Abrufen der Inhaltsinformationen 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.
PEERDIST_ERROR_NOT_FOUND
 Die angegebenen Inhaltsbezeichnerdaten werden nicht veröffentlicht.
ERROR_ACCESS_DISABLED_BY_POLICY
 Das Feature wird durch Gruppenrichtlinie deaktiviert.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 Der Dienst ist nicht verfügbar.

Hinweise

Wenn die Funktion erfolgreich ist, kann das von phContentInfo empfangene Handle an den übergeben werden.
PeerDistServerRetrieveContentInformation-Funktion zum Abrufen von Inhaltsinformationen. Das Handle muss über die Funktion PeerDistServerCloseContentInformation geschlossen werden.

Wenn ullContentOffset und cbContentLength beide null sind, werden die Inhaltsinformationen für den gesamten Inhalt abgerufen.

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

PeerDistServerRetrieveContentInformation