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

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

  • Статья

Функция PeerDistServerRetrieveContentInformation извлекает закодированные сведения о содержимом, связанные с дескриптором, возвращенным PeerDistServerOpenContentInformation.

Синтаксис

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

Параметры

[in] hPeerDist

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

[in] hContentInfo

Дескриптор, возвращаемый PeerDistServerOpenContentInformation.

cbMaxNumberOfBytes

Максимальное число байтов, предназначенных для чтения.

[in, out] pBuffer

Указатель на буфер, который получает данные сведений о содержимом.

[in] lpOverlapped

Указатель на структуру OVERLAPPED . Эта функция не позволяет вызывающей объекту указать начальную смещение в содержимом. Смещение неявно поддерживается для каждого hContentInfo. Значения Offset и OffsetHigh зарезервированы и должны быть равны нулю.

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

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

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

Комментарии

При успешном выполнении операции PeerDistServerRetrieveContentInformation поля Offset и OffsetHigh структуры OVERLAPPED будут заполнены смещением ULONGLONG в полученной информации о содержимом. Для элемента OffsetHigh будут заданы более высокие 32 бита смещения, а для элемента Offset — нижние 32 бита смещения.

GetOverlappedResult заполняет lpNumberOfBytesTransferred количеством переданных байтов. Если вызывающий объект использует порт завершения для обработки завершений API однорангового распределения, аргумент lpNumberOfBytesgetQueuedCompletionStatus будет заполнен количеством переданных байтов.

Требования

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

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

PeerDistServerOpenContentInformation

PeerDistStartup