Метод IHttpTraceContext::GetTraceActivityId

Возвращает идентификатор действия трассировки для контекста трассировки.

Синтаксис

virtual LPCGUID GetTraceActivityId(  
) = 0;  

Параметры

Этот метод не принимает параметров.

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

Указатель на константный GUID; в противном случае — NULL.

Комментарии

Поведение этого метода зависит от реализации. Некоторые реализации всегда возвращают значение NULL, в то время как другие вызывают метод IHttpRequest::GetRawHttpRequest для внутреннего указателя IHttpRequest и преобразуют возвращенный указатель HTTP_REQUEST в const указатель GUID.

Внимание!

Так как некоторые разработчики возвращают значение NULL, перед выполнением каких-либо операций с данными всегда убедитесь, что возвращенный LPCGUID не имеет значения NULL.

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

Разработчики IHttpTraceContext отвечают за управление памятью с помощью этих данных; Поэтому разработчики, использующие динамическое выделение памяти, IHttpTraceContext должны освобождать или вызывать delete указатель LPCGUID, когда он больше не нужен.

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

IHttpTraceContext разработчики отвечают за управление памятью с помощью этих данных; IHttpTraceContext Поэтому клиенты не должны освобождать или вызывать delete возвращенный указатель LPCGUID, если эти данные больше не нужны. Кроме того, клиенты не должны приводить эти данные к указателю, который не const является , или изменять состояние памяти, на которую ссылается этот LPCGUID; в противном случае будет вызвано нарушение доступа или данные станут недействительными.

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