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 |