추적 컨텍스트에 대한 추적 활동 식별자를 반환합니다.
구문
virtual LPCGUID GetTraceActivityId(
) = 0;
매개 변수
이 메서드는 매개 변수를 사용하지 않습니다.
반환 값
상수 GUID에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
이 메서드의 동작은 구현에 따라 달라집니다. 일부 구현은 항상 NULL을 반환하지만 다른 구현은 내부 IHttpRequest 포인터에서 IHttpRequest::GetRawHttpRequest 메서드를 호출하고 반환된 HTTP_REQUEST 포인터를 const GUID 포인터로 변환합니다.
주의
일부 구현자는 NULL을 반환하므로 이 데이터에 대한 작업을 수행하기 전에 반환된 LPCGUID가 NULL이 아닌지 항상 확인합니다.
구현자에 대한 참고 사항
IHttpTraceContext 구현자는 이 데이터로 메모리 관리를 담당합니다. 따라서 IHttpTraceContext 동적 메모리 할당을 사용하는 구현자는 더 이상 필요하지 않은 경우 LPCGUID 포인터를 해제하거나 호출 delete 해야 합니다.
호출자 참고 사항
IHttpTraceContext 구현자는 이 데이터를 사용하여 메모리 관리를 담당합니다. 따라서 IHttpTraceContext 클라이언트는 이 데이터가 더 이상 필요하지 않은 경우 반환된 LPCGUID 포인터를 해제하거나 호출 delete 하지 않아야 합니다. 또한 클라이언트는 이 데이터를 이 LPCGUID에서 참조하는 메모리 상태가 아닌 const 포인터로 캐스팅하거나 변경해서는 안 됩니다. 그렇지 않으면 액세스 위반이 발생하거나 데이터가 유효하지 않습니다.
네이티브 DLL 모듈을 만들고 배포하는 방법에 대한 자세한 내용은 연습: 네이티브 코드를 사용하여 Request-Level HTTP 모듈 만들기를 참조하세요.
요구 사항
| 형식 | Description |
|---|---|
| 클라이언트 | - 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 |