다음을 통해 공유


IHttpTraceContext::GetTraceConfiguration 메서드

추적 컨텍스트에 대한 추적 구성을 반환합니다.

구문

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 메서드