Метод 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 |