PeerDistServerOpenContentInformationEx-Funktion (peerdist.h)
Die Funktion PeerDistServerOpenContentInformationEx öffnet eine PEERDIST_CONTENTINFO_HANDLE. Der Client verwendet das Handle, um Inhaltsinformationen abzurufen.
Syntax
DWORD PeerDistServerOpenContentInformationEx(
[in] PEERDIST_INSTANCE_HANDLE hPeerDist,
[in] DWORD cbContentIdentifier,
[in] PBYTE pContentIdentifier,
ULONGLONG ullContentOffset,
ULONGLONG cbContentLength,
[in] PEERDIST_RETRIEVAL_OPTIONS *pRetrievalOptions,
[in, optional] HANDLE hCompletionPort,
[in, optional] ULONG_PTR ulCompletionKey,
[out] PPEERDIST_CONTENTINFO_HANDLE phContentInfo
);
Parameter
[in] hPeerDist
Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.
[in] 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] pRetrievalOptions
Eine PEER_RETRIEVAL_OPTIONS-Struktur , die zusätzliche Optionen zum Abrufen von Inhaltsinformationen angibt.
[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.
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.
Der Parameter pRetrievalOptions kann verwendet werden, um den Bereich der Inhaltsinformationsversionen anzugeben, für den der anfordernde Client für die Verarbeitung konfiguriert ist. Dadurch kann der Client eine anwendbare Version der Inhaltsinformationsstruktur abrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | peerdist.h |
Weitere Informationen
PeerDistServerCloseContentInformation