다음을 통해 공유

TdhGetEventMapInformation 함수(tdh.h)

  • 아티클

이벤트에 포함된 이벤트 맵에 대한 정보를 검색합니다.

구문

TDHSTATUS TdhGetEventMapInformation(
  [in]      PEVENT_RECORD   pEvent,
  [in]      PWSTR           pMapName,
  [out]     PEVENT_MAP_INFO pBuffer,
  [in, out] ULONG           *pBufferSize
);

매개 변수

[in] pEvent

EventRecordCallback 콜백에 전달된 이벤트 레코드입니다. 자세한 내용은 EVENT_RECORD 구조를 참조하세요.

[in] pMapName

맵 특성 값의 이름을 포함하는 Null로 종료된 유니코드 문자열입니다. 이름은 EVENT_PROPERTY_INFO 구조체의 MapNameOffset 멤버에서 가져옵니다.

[out] pBuffer

이벤트 맵을 수신하기 위해 사용자가 할당한 버퍼입니다. 맵은 값 맵, 비트맵 또는 패턴 맵일 수 있습니다. 자세한 내용은 EVENT_MAP_INFO 구조를 참조하세요.

[in, out] pBufferSize

pBuffer 버퍼의 크기(바이트)입니다. 함수가 성공하면 이 매개 변수는 사용된 버퍼의 크기를 받습니다. 버퍼가 너무 작으면 함수는 ERROR_INSUFFICIENT_BUFFER 반환하고 이 매개 변수를 필요한 버퍼 크기로 설정합니다. 입력 시 버퍼 크기가 0이면 버퍼에 데이터가 반환되지 않으며 이 매개 변수는 필요한 버퍼 크기를 받습니다.

반환 값

성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 다른 코드 외에도 다음 반환 코드 중 하나를 반환합니다.

반환 코드 설명
ERROR_INSUFFICIENT_BUFFER
 pBuffer 버퍼의 크기가 너무 작습니다. pBufferSize에 설정된 필수 버퍼 크기를 사용하여 새 버퍼를 할당합니다.
ERROR_NOT_FOUND
 이벤트에 대한 스키마를 찾을 수 없거나 지정된 맵을 찾을 수 없습니다.
ERROR_FILE_NOT_FOUND
 매니페스트의 resourceFileName 특성에는 공급자 이진 파일의 위치가 포함됩니다. 매니페스트를 등록하면 위치가 레지스트리에 기록됩니다. TDH가 등록된 위치에 따라 이진 파일을 찾을 수 없습니다.
ERROR_INVALID_PARAMETER
 하나 이상의 매개 변수가 잘못되었습니다.
ERROR_WMI_SERVER_UNAVAILABLE
 WMI 서비스를 사용할 수 없습니다.

설명

이 함수를 사용하여 WPP 이벤트에 대한 이벤트 맵 정보를 검색할 수 없습니다.

매니페스트에 정의된 맵의 경우 문자열 끝에 공백이 포함됩니다. 예를 들어 매니페스트에서 값이 "Monday"에 매핑되는 경우 문자열은 "Monday"로 반환됩니다.

예제

이 함수를 호출하는 방법을 보여 주는 예제는 TdhGetProperty를 사용하여 이벤트 데이터 사용을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tdh.h
라이브러리 Tdh.lib
DLL Tdh.dll