Функция PeerDistClientOpenContent (peerdist.h)

Статья
08/25/2023

Откроется функция PeerDistClientOpenContent и возвращает PEERDIST_CONTENT_HANDLE. Клиент использует дескриптор содержимого для получения данных из службы однорангового распределения.

Синтаксис

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

Параметры

[in] hPeerDist

PEERDIST_INSTANCE_HANDLE, возвращенный PeerDistStartup.

[in] pContentTag

Указатель на структуру PEERDIST_CONTENT_TAG , содержащую 16-байтовый идентификатор клиента. Этот параметр используется совместно с функцией PeerDistClientFlushContent .

[in, optional] hCompletionPort

Дескриптор порта завершения, который можно использовать для получения уведомления о завершении асинхронной функции. Чтобы создать порт завершения, используйте функцию CreateIoCompletionPort . Этот параметр может иметь значение NULL.

[in, optional] ulCompletionKey

Значение, возвращаемое с помощью параметра lpCompletionKey функции GetQueuedCompletionStatus . Этот параметр игнорируется, если hCompletionPort имеет значение NULL.

[out] phContentHandle

Указатель на переменную, получающую PEERDIST_CONTENT_HANDLE , используемую для получения или добавления данных.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS. В противном случае функция может вернуть одно из следующих значений:

Код возврата	Описание
ERROR_INVALID_PARAMETER	Один или несколько параметров недопустимы.
ERROR_INVALID_HANDLE	Недопустимый дескриптор hPeerDist.
ERROR_ACCESS_DISABLED_BY_POLICY	Эта функция отключена групповая политика.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Служба недоступна.

Требования


Минимальная версия клиента	Windows 7 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	peerdist.h
Библиотека	PeerDist.lib
DLL	PeerDist.dll