Funzione PeerDistServerOpenContentInformation (peerdist.h)

La funzione PeerDistServerOpenContentInformation apre una PEERDIST_CONTENTINFO_HANDLE. Il client usa l'handle per recuperare le informazioni sul contenuto.

Sintassi

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

Parametri

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE restituito da PeerDistStartup.

cbContentIdentifier

Lunghezza, in byte, dell'identificatore di contenuto.

[in] pContentIdentifier

Puntatore a un buffer contenente l'identificatore di contenuto.

ullContentOffset

Offset dall'inizio del contenuto pubblicato per il quale viene richiesto l'handle di informazioni sul contenuto.

cbContentLength

Lunghezza, in byte, del contenuto (a partire da ullContentOffset) per cui vengono richieste le informazioni sul contenuto.

[in, optional] hCompletionPort

Handle alla porta di completamento utilizzata 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] phContentInfo

Handle utilizzato per recuperare le informazioni sul contenuto.

Valore restituito

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

Commenti

Se la funzione ha esito positivo, l'handle ricevuto da phContentInfo può essere passato all'oggetto
Funzione PeerDistServerRetrieveContentInformation per recuperare le informazioni sul contenuto. L'handle deve essere chiuso tramite la funzione PeerDistServerCloseContentInformation .

Se ullContentOffset e cbContentLength sono entrambi zero, verranno recuperate le informazioni sul contenuto per l'intero contenuto.

Requisiti

Vedi anche

PeerDistServerRetrieveContentInformation