Метод IHttpTraceContext::SetTraceConfiguration
Задает конфигурацию трассировки для контекста трассировки.
Синтаксис
virtual HRESULT SetTraceConfiguration(
IN HTTP_MODULE_ID moduleId,
IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,
IN DWORD cHttpTraceConfiguration = 1
) = 0;)
Параметры
moduleId
[IN] Указатель HTTP_MODULE_ID , содержащий идентификатор модуля для конфигурации трассировки.
pHttpTraceConfiguration
[IN] Массив HTTP_TRACE_CONFIGURATION структур длины cHttpTraceConfiguration.
cHttpTraceConfiguration
[IN] Объект , DWORD содержащий количество структур, HTTP_TRACE_CONFIGURATION на которые указывает .pHttpTraceConfiguration Значение по умолчанию — 1.
Примечание
HTTP_MODULE_ID — это определение типа указателя void .
Возвращаемое значение
Объект HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Значение | Определение |
|---|---|
| S_OK | Указывает, что операция прошла успешно. |
| E_FAIL | Указывает, что операция завершилась сбоем. |
| E_OUTOFMEMORY | Указывает, что внутренняя new операция вернула значение NULL, так как память кучи исчерпана. |
| ERROR_INVALID_PARAMETER | Указывает, что HTTP_TRACE_CONFIGURATION::pProviderGuid свойство параметра pHttpTraceConfiguration имеет значение NULL. |
| ERROR_NOT_FOUND | Указывает, что для несуществующего поставщика была предпринята попытка отключить трассировку. |
Комментарии
Ни параметр , moduleId ни pHttpTraceConfiguration параметр не может иметь значение NULL; в SetTraceConfiguration противном случае метод вызовет нарушение доступа.
Потокобезопасность
Большинство реализаций интерфейса IHttpTraceContext являются потокобезопасны, если вызывается только метод GetTraceConfiguration . SetTraceConfiguration Вызов метода не гарантирует потокобезопасность.
Комментарии
Дополнительные сведения о создании и развертывании собственного модуля DLL см. в разделе Пошаговое руководство. Создание модуля HTTP Request-Level с помощью машинного кода.
Требования
| Тип | Описание |
|---|---|
| клиент | — IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10 |
| Сервер | — IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016 |
| Продукт | — IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0 |
| Заголовок | Httpserv.h |