共用方式為


IHttpTraceCoNtext::GetTraceActivityId 方法

傳回追蹤內容的追蹤活動識別碼。

語法

virtual LPCGUID GetTraceActivityId(  
) = 0;  

參數

此方法不會採用任何參數。

傳回值

常數 GUID 的指標;否則為 Null。

備註

這個方法的行為取決於實作。 有些實作一律會傳回 Null,而其他實作則會在內部IHttpRequest指標上呼叫IHttpRequest::GetRawHttpRequest方法,並將傳回的HTTP_REQUEST指標轉換為 GUID 指標 const

警告

由於某些實作者會傳回 Null,因此在您對此資料執行任何作業之前,請一律確認傳回的 LPCGUID 不是 Null。

實作者的注意事項

IHttpTraceCoNtext 實作者負責使用此資料的記憶體管理;因此,當不再需要動態記憶體配置時, IHttpTraceContext 使用動態記憶體配置的實作者必須釋放或呼叫 delete LPCGUID 指標。

來電者的附注

IHttpTraceContext 實作者負責使用此資料的記憶體管理;因此,當不再需要此資料時, IHttpTraceContext 用戶端不得在傳回的 LPCGUID 指標上釋放或呼叫 delete 。 此外,用戶端不得將此資料轉換成不是 const 或變更此 LPCGUID 所參考之記憶體狀態的指標,否則會擲回存取違規,否則資料將會變成無效。

如需如何建立及部署原生 DLL 模組的詳細資訊,請參閱逐步解說 :使用機器碼建立Request-Level HTTP 模組

規格需求

類型 描述
Client - Windows Vista 上的 IIS 7.0
- Windows 7 上的 IIS 7.5
- Windows 8 上的 IIS 8.0
- Windows 10上的 IIS 10.0
伺服器 - Windows Server 2008 上的 IIS 7.0
- Windows Server 2008 R2 上的 IIS 7.5
- Windows Server 2012 上的 IIS 8.0
- Windows Server 2012 R2 上的 IIS 8.5
- Windows Server 2016上的 IIS 10.0
產品 - 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 介面