TraceLoggingSocketAddress 매크로(traceloggingprovider.h)

소켓 주소가 있는 필드를 이벤트에 추가하는 TraceLogging 래퍼 매크로입니다.

구문

void TraceLoggingSocketAddress(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

매개 변수

[in] pValue

sockaddr 구조체에 대한 포인터입니다.

[in] cbValue

pValue 매개 변수가 가리키는 값의 크기(바이트)입니다.

참고

sockaddr 필드에 필요한 데이터의 양은 주소 유형에 따라 달라집니다. 데이터가 공용 구조체 변수에 저장된 경우 데이터를 잘림하지 않으려면 cbValue 매개 변수를 올바른 공용 구조체 멤버의 크기(또는 공용 구조체의 크기)로 설정해야 합니다.

[in, optional] __VA_ARGS__

필드 정의에 대한 선택적 이름, 설명 및 태그 매개 변수입니다.

TraceLoggingSocketAddress는 2, 3, 4 또는 5개의 매개 변수로 지정할 수 있습니다. 매개 변수를 지정하지 않으면 기본값이 사용됩니다. 예를 들어 TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr))는 TraceLoggingSocketAddress(&x.sockAddr, sizeof(x.sockAddr), "&x.sockAddr", "", 0)와 같습니다.

• [in, optional] name

  이벤트 필드에 사용할 이름입니다. 제공된 경우 name 매개 변수는 문자열 리터럴(변수 아님)이어야 하며 '\0' 문자를 포함하지 않아야 합니다. 제공되지 않으면 이벤트 필드 이름은 pValue를 기반으로 합니다.

• [in, optional] description

  이벤트 필드 값에 대한 설명입니다. 제공된 경우 description 매개 변수는 문자열 리터럴이어야 하며 PDB에 포함됩니다.

• [in, optional] tags

  컴파일 시간 상수 정수 값입니다. 낮은 28비트 값은 필드의 메타데이터에 포함됩니다. 이 값의 의미 체계는 이벤트 소비자에 의해 정의됩니다. 이벤트 처리 중에 이 값은 EVENT_PROPERTY_INFO 태그 필드에서 검색할 수 있습니다.

반환 값

없음

설명

TraceLoggingSocketAddress(pValue, cbValue, ...)는 TraceLoggingWrite 매크로 호출에 대한 매개 변수로 사용할 수 있습니다. 각 TraceLoggingSocketAddress 매개 변수는 이벤트에 하나의 필드를 추가합니다.

값은 SOCKADDR, SOCKADDR_IN, SOCKADDR_IN6, SOCKADDR_STORAGE 등 Windows sockaddr 형식일 수 있습니다. 이벤트는 원시 이진 데이터 및 데이터 크기를 기록합니다. 이벤트 디코더는 필드를 사용하여 sa_family 소켓 주소의 실제 형식을 결정합니다.

참고

모든 디코더가 모든 sockaddr 제품군 유형을 지원하지는 않습니다. 지원되지 않는 sockaddr이 발견되면 디코더는 필드를 주소로 서식을 지정하는 대신 원시 이진 데이터로 디코딩할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	traceloggingprovider.h

추가 정보

TraceLoggingWrite

추적 로깅 래퍼 매크로