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

Метод IBackgroundCopyJobHttpOptions::GetCustomHeaders (bits2_5.h)

  • Статья

Извлекает пользовательские заголовки, заданные при предыдущем вызове IBackgroundCopyJobHttpOptions::SetCustomHeaders (то есть заголовки, которые BITS будет отправлять в удаленный репозиторий, а не заголовки, которые BITS получает из удаленного репозитория).

Синтаксис

HRESULT GetCustomHeaders(
  [out] LPWSTR *pRequestHeaders
);

Параметры

[out] pRequestHeaders

Строка с завершением NULL, содержащая пользовательские заголовки. Каждый заголовок завершается символом возврата каретки и перевода строки (CR/LF). Чтобы освободить строку после завершения, вызовите функцию CoTaskMemFree .

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

В следующей таблице перечислены некоторые из возможных возвращаемых значений.

Код возврата Описание
S_OK
 Заголовки успешно извлечены.
S_FALSE
 Задание не указывает пользовательские заголовки.
E_ACCESSDENIED
 Либо у вас нет разрешения на получение пользовательских заголовков, либо в задании был вызван [IBackgroundCopyJobHttpOptions3::MakeCustomHeadersWriteOnly](/windows/desktop/api/bits10_3/nf-bits10_3-ibackgroundcopyjobhttpoptions3-makecustomheaderswriteonly).
RPC_X_NULL_REF_POINTER
 Параметр pRequestHeaders имеет значение NULL.

Комментарии

Только владелец задания может получить пользовательские заголовки. Чтобы указать заголовки, вызовите метод IBackgroundCopyJobHttpOptions::SetCustomHeaders .

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header bits2_5.h (включая Bits.h)
Библиотека Bits.lib

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

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::SetCustomHeaders