Funzione PeerDistClientOpenContent (peerdist.h)

Articolo
08/25/2023

La funzione PeerDistClientOpenContent viene aperta e restituisce un PEERDIST_CONTENT_HANDLE. Il client usa l'handle di contenuto per recuperare i dati dal servizio Distribuzione peer.

Sintassi

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
);

Parametri

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE restituito da PeerDistStartup.

[in] pContentTag

Puntatore a una struttura PEERDIST_CONTENT_TAG contenente un identificatore specificato dal client di 16 byte. Questo parametro viene usato insieme alla funzione PeerDistClientFlushContent .

[in, optional] hCompletionPort

Handle alla porta di completamento che può essere usata per recuperare la notifica di completamento della funzione asincrona. Per creare una porta di completamento, usare la funzione CreateIoCompletionPort Questo parametro può essere NULL.

[in, optional] ulCompletionKey

Valore da restituire tramite il parametro lpCompletionKey della funzione GetQueuedCompletionStatus . Questo parametro viene ignorato quando hCompletionPort è NULL.

[out] phContentHandle

Puntatore a una variabile che riceve la PEERDIST_CONTENT_HANDLE usata per recuperare o aggiungere dati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS. In caso contrario, la funzione può restituire uno dei valori seguenti:

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno o più parametri non sono validi.
ERROR_INVALID_HANDLE	L'handle hPeerDist non è valido.
ERROR_ACCESS_DISABLED_BY_POLICY	La funzionalità è disabilitata da Criteri di gruppo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Il servizio non è disponibile.

Commenti

Il client deve chiamare la funzione PeerDistClientOpenContent per ottenere un handle PEERDIST_CONTENT_HANDLE che in seguito può essere usato nelle funzioni seguenti:

Se viene specificato un handle di porta di completamento facoltativo, viene usato per pubblicare i risultati di completamento delle funzioni asincrone elencate sopra.

L'handle restituito dalla chiamata di funzione PeerDistClientOpenContent deve essere chiuso dalla funzione PeerDistClientCloseContent .

Requisiti


Client minimo supportato	Windows 7 Professional [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	peerdist.h
Libreria	PeerDist.lib
DLL	PeerDist.dll