추적 컨텍스트에 대한 추적 구성을 반환합니다.
구문
virtual HRESULT GetTraceConfiguration(
IN OUT HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration
) = 0;
매개 변수
pHttpTraceConfiguration
[IN] [OUT] 추적 구성에 대한 정보를 포함하는 HTTP_TRACE_CONFIGURATION 구조체에 대한 포인터입니다.
반환 값
HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 값 | 정의 |
|---|---|
| S_OK | 작업이 성공했음을 나타냅니다. |
설명
GetTraceConfigurationRaiseTraceEvent 메서드를 호출하기 전에 메서드를 호출하여 이벤트 소비자가 있는지 확인합니다.
참고
현재 IHttpTraceContext 구현자는 에서 GetTraceConfigurationS_OK만 반환하지만 구현이 변경될 수 있으므로 각각 SUCCEEDED 또는 FAILED 매크로에 반환 HRESULT 된 를 전달하여 성공 또는 실패를 테스트해야 합니다.
스레드 보안
IHttpTraceContext 인터페이스의 대부분의 구현자는 메서드만 GetTraceConfiguration 호출되는 경우 스레드로부터 안전합니다. SetTraceConfiguration 메서드를 호출해도 스레드로부터 안전한 것은 아닙니다.
구현자에 대한 참고 사항
호출자는 더 이상 필요하지 않은 경우 이 데이터를 HTTP_TRACE_CONFIGURATION 삭제해야 하므로 메서드의 구현자는 GetTraceConfiguration 내부 데이터를 구조로 복사할 책임이 있습니다.
호출자 참고 사항
메서드 호출 GetTraceConfiguration 자는 이 데이터가 더 이상 필요하지 않을 때 데이터 HTTP_TRACE_CONFIGURATION 및 해당 필드를 삭제해야 합니다.
네이티브 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 |
참고 항목
IHttpTraceContext 인터페이스
IHttpTraceContext::SetTraceConfiguration 메서드