Поделиться через

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

  • Статья

Функция PeerDistServerOpenContentInformation открывает PEERDIST_CONTENTINFO_HANDLE. Клиент использует дескриптор для получения сведений о содержимом.

Синтаксис

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

Параметры

[in] hPeerDist

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

cbContentIdentifier

Длина идентификатора содержимого (в байтах).

[in] pContentIdentifier

Указатель на буфер, содержащий идентификатор содержимого.

ullContentOffset

Смещение от начала опубликованного содержимого, для которого запрашивается обработка сведений о содержимом.

cbContentLength

Длина (в байтах) содержимого (начиная с ullContentOffset), для которого запрашивается информация о содержимом.

[in, optional] hCompletionPort

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

[in, optional] ulCompletionKey

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

[out] phContentInfo

Дескриптор, используемый для получения сведений о содержимом.

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

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

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

Комментарии

Если функция выполнена успешно, дескриптор, полученный phContentInfo , можно передать в
Функция PeerDistServerRetrieveContentInformation для получения сведений о содержимом. Дескриптор должен быть закрыт с помощью функции PeerDistServerCloseContentInformation .

Если значения ullContentOffset и cbContentLength равны нулю, будут получены сведения о содержимом для всего содержимого.

Требования

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

См. также раздел

PeerDistServerRetrieveContentInformation