Funzione PeerDistClientAddContentInformation (peerdist.h)

  • Articolo

La funzione PeerDistClientAddContentInformation aggiunge le informazioni sul contenuto associate a un handle di contenuto aperto da PeerDistClientOpenContent.

Sintassi

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

Parametri

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE restituito da PeerDistStartup.

[in] hContentHandle

Un PEERDIST_CONTENT_HANDLE aperto da PeerDistClientOpenContent.

cbNumberOfBytes

Numero di byte nella matrice pBuffer .

[in] pBuffer

Puntatore al buffer contenente le informazioni sul contenuto. Questo buffer deve rimanere valido per la durata dell'operazione di aggiunta. Il chiamante non deve usare questo buffer finché non viene completata l'operazione di aggiunta.

[in] lpOverlapped

Puntatore a una struttura OVERLAPPED . Il membro interno della struttura OVERLAPPED contiene lo stato di completamento dell'operazione asincrona. Offset e OffsetHigh sono riservati e devono essere 0.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_IO_PENDING. 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

Per recuperare i dati del contenuto dal servizio Di distribuzione peer, il client deve aggiungere informazioni sul contenuto ricevute dal server di contenuto chiamando la funzione PeerDistClientAddContentInformation . Quando sono stati aggiunti tutti i dati delle informazioni sul contenuto, è necessario chiamare la funzione PeerDistClientCompleteContentInformation . Al termine del completamento di PeerDistClientCompleteContentInformation , il client può chiamare PeerDistClientStreamRead o PeerDistClientBlockRead per recuperare i dati dal sistema di distribuzione peer.

Quando si chiama questa funzione più volte su un singolo handle di contenuto, il chiamante deve attendere il completamento di ogni operazione prima che venga eseguita la chiamata successiva.

Un'applicazione non è limitata all'aggiunta di informazioni sul contenuto con una singola chiamata API PeerDistClientAddContentInformation , in quanto è possibile aggiungere parti di tali informazioni sul contenuto in quanto sono rese disponibili. Quando sono disponibili altre informazioni sul contenuto, l'applicazione può chiamare nuovamente PeerDistClientAddContentInformation. Al termine dell'aggiunta di tutte le informazioni sul contenuto, l'applicazione deve quindi chiamare PeerDistClientCompleteContentInformation.

Requisiti

Requisito Valore
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

Vedi anche

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup