Метод IHttpTraceContext::GetTraceConfiguration

Возвращает конфигурацию трассировки для контекста трассировки.

Синтаксис

virtual HRESULT GetTraceConfiguration(  
   IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration  
) = 0;  

Параметры

pHttpTraceConfiguration
[IN] [OUT] Указатель на структуру HTTP_TRACE_CONFIGURATION , содержащую сведения о конфигурации трассировки.

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

Объект HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Значение	Определение
S_OK	Указывает, что операция выполнена успешно.

Комментарии

Вызовите метод , GetTraceConfiguration чтобы определить, существует ли потребитель события перед вызовом метода RaiseTraceEvent .

Примечание

Хотя текущие реализации IHttpTraceContext возвращают только S_OK из GetTraceConfiguration, следует проверить успешность или сбой, передав возвращаемый HRESULTмакросам SUCCEEDED или FAILED соответственно, так как реализация может измениться.

Потокобезопасность

Большинство средств реализации интерфейса IHttpTraceContext являются потокобезопасны, если вызывается только GetTraceConfiguration метод . Вызов метода SetTraceConfiguration не гарантирует потокобезопасность.

Примечания для разработчиков

Разработчики GetTraceConfiguration метода отвечают за копирование всех внутренних данных в структуру HTTP_TRACE_CONFIGURATION , так как вызывающие несут ответственность за удаление этих данных, когда они больше не нужны.

Примечания для вызывающих абонентов

Вызывающие GetTraceConfiguration методы отвечают за удаление всех HTTP_TRACE_CONFIGURATION данных и их полей, когда эти данные больше не нужны.

Дополнительные сведения о создании и развертывании собственного модуля 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

См. также:

Интерфейс IHttpTraceContext
Метод IHttpTraceContext::SetTraceConfiguration