Funzione PeerDistServerOpenContentInformation (peerdist.h)

  • Articolo

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:

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

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

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

PeerDistServerRetrieveContentInformation