Función PeerDistClientOpenContent (peerdist.h)

Artículo
08/25/2023

Se abre la función PeerDistClientOpenContent y devuelve un PEERDIST_CONTENT_HANDLE. El cliente usa el identificador de contenido para recuperar datos del servicio de distribución del mismo nivel.

Sintaxis

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

Parámetros

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE devuelto por PeerDistStartup.

[in] pContentTag

Puntero a una estructura de PEERDIST_CONTENT_TAG que contiene un identificador especificado por el cliente de 16 bytes. Este parámetro se usa junto con la función PeerDistClientFlushContent .

[in, optional] hCompletionPort

Identificador del puerto de finalización que se puede usar para recuperar la notificación de finalización de la función asincrónica. Para crear un puerto de finalización, use la función CreateIoCompletionPort Este parámetro puede ser NULL.

[in, optional] ulCompletionKey

Valor que se va a devolver a través del parámetro lpCompletionKey de la función GetQueuedCompletionStatus . Este parámetro se omite cuando hCompletionPort es NULL.

[out] phContentHandle

Puntero a una variable que recibe el PEERDIST_CONTENT_HANDLE usado para recuperar o agregar datos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS. De lo contrario, es posible que la función devuelva uno de los siguientes valores:

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	Uno o varios parámetros no son válidos.
ERROR_INVALID_HANDLE	El identificador hPeerDist no es válido.
ERROR_ACCESS_DISABLED_BY_POLICY	La característica está deshabilitada por directiva de grupo.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	El servicio no está disponible.

Comentarios

El cliente debe llamar a la función PeerDistClientOpenContent para obtener un identificador de PEERDIST_CONTENT_HANDLE que se pueda usar más adelante en las funciones siguientes:

Si se especifica un identificador de puerto de finalización opcional, se usa para registrar los resultados de finalización de las funciones asincrónicas enumeradas anteriormente.

La función PeerDistClientOpenContent debe cerrar el identificador devuelto por la función PeerDistClientCloseContent .

Requisitos


Cliente mínimo compatible	Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	peerdist.h
Library	PeerDist.lib
Archivo DLL	PeerDist.dll