추적 컨텍스트에 대한 추적 구성을 설정합니다.
구문
virtual HRESULT SetTraceConfiguration(
IN HTTP_MODULE_ID moduleId,
IN HTTP_TRACE_CONFIGURATION* pHttpTraceConfiguration,
IN DWORD cHttpTraceConfiguration = 1
) = 0;)
매개 변수
moduleId
[IN] HTTP_MODULE_ID 추적 구성에 대한 모듈 식별자를 포함하는 포인터입니다.
pHttpTraceConfiguration
[IN] HTTP_TRACE_CONFIGURATION 구조체 의 배열입니다 cHttpTraceConfiguration.
cHttpTraceConfiguration
[IN] DWORD 가 가리키는 pHttpTraceConfiguration구조체의 HTTP_TRACE_CONFIGURATION 수를 포함하는 입니다. 기본값은 1입니다.
참고
HTTP_MODULE_ID 는 포인터의 형식 정의입니다 void .
반환 값
HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 값 | 정의 |
|---|---|
| S_OK | 작업이 성공했음을 나타냅니다. |
| E_FAIL | 작업이 실패했음을 나타냅니다. |
| E_OUTOFMEMORY | 힙 메모리가 소진되어 내부 new 작업이 NULL을 반환했음을 나타냅니다. |
| ERROR_INVALID_PARAMETER | 매개 변수의 HTTP_TRACE_CONFIGURATION::pProviderGuid 속성이 pHttpTraceConfiguration NULL임을 나타냅니다. |
| ERROR_NOT_FOUND | 존재하지 않는 공급자에 대해 추적을 사용하지 않도록 설정하려는 시도가 발생했음을 나타냅니다. |
설명
및 매개 변수는 pHttpTraceConfiguration NULL일 수 없습니다moduleId. 그렇지 않으면 메서드가 SetTraceConfiguration 액세스 위반을 발생합니다.
스레드 보안
GetTraceConfiguration 메서드만 호출되는 경우 IHttpTraceContext 인터페이스의 대부분의 구현자는 스레드로부터 안전합니다. 메서드를 호출해 SetTraceConfiguration 도 스레드로부터 안전한 것은 아닙니다.
의견
네이티브 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 |