PdhOpenLogW 함수(pdh.h)
읽기 또는 쓰기를 위해 지정된 로그 파일을 엽니다.
통사론
PDH_FUNCTION PdhOpenLogW(
[in] LPCWSTR szLogFileName,
[in] DWORD dwAccessFlags,
[in] LPDWORD lpdwLogType,
[in] PDH_HQUERY hQuery,
[in] DWORD dwMaxSize,
[in] LPCWSTR szUserCaption,
[out] PDH_HLOG *phLog
);
매개 변수
[in] szLogFileName
열 로그 파일의 이름을 지정하는 Null종료된 문자열입니다. 이름에는 절대 경로 또는 상대 경로가 포함될 수 있습니다.
[in] dwAccessFlags
로그 파일을 여는 데 사용할 액세스 유형입니다. 다음 값 중 하나를 지정합니다.
| 값 | 의미 |
|---|---|
|
읽기 위해 로그 파일을 엽니다. |
|
쓰기 위해 새 로그 파일을 엽니다. |
|
쓰기 위해 기존 로그 파일을 엽니다. |
비트 포함 OR 연산자(|)를 사용하여 액세스 형식을 다음 생성 플래그 중 하나 이상과 결합할 수 있습니다.
| 값 | 의미 |
|---|---|
|
지정된 이름을 사용하여 새 로그 파일을 만듭니다. |
|
지정된 이름을 사용하여 새 로그 파일을 만듭니다. 로그 파일이 이미 있는 경우 함수는 새 파일을 만들기 전에 기존 로그 파일을 제거합니다. |
|
지정된 이름의 기존 로그 파일을 엽니다. 지정된 이름의 로그 파일이 없으면 PDH_LOG_CREATE_NEW 같습니다. |
|
지정된 이름의 기존 로그 파일을 열거나 지정된 이름으로 새 로그 파일을 만듭니다. |
|
지정된 이름을 사용하여 순환 로그 파일을 만듭니다. 파일이 dwMaxSize 매개 변수의 값에 도달하면 데이터가 로그 파일의 시작 부분으로 래핑됩니다. lpdwLogType 매개 변수가 PDH_LOG_TYPE_BINARY경우에만 이 플래그를 지정할 수 있습니다. |
|
PDH_LOG_TYPE_TSVPdhUpdateLog 또는 PdhOpenLogszUserString 매개 변수로 표시된 사용자 캡션 또는 로그 파일 설명을 작성하는 데 사용됩니다. 사용자 캡션 또는 로그 파일 설명은 텍스트 로그의 첫 번째 줄에서 마지막 열로 작성됩니다. |
[in] lpdwLogType
열 로그 파일의 형식입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
[in] hQuery
로그 파일에 쿼리 데이터를 쓰는 경우 쿼리 핸들을 지정합니다. PdhOpenQuery 함수는 이 핸들을 반환합니다.
이 매개 변수는 무시되며 로그 파일에서 읽는 경우 NULL
[in] dwMaxSize
로그 파일의 최대 크기(바이트)입니다. 파일 크기를 제한하려는 경우 또는 dwAccessFlagsPDH_LOG_OPT_CIRCULAR지정하는 경우 최대 크기를 지정합니다. 그렇지 않으면 0으로 설정합니다.
순환 로그 파일의 경우 하나 이상의 샘플을 저장할 수 있을 만큼 큰 값을 지정해야 합니다. 샘플 크기는 수집되는 데이터에 따라 달라집니다. 그러나 하나 이상의 메가바이트 값을 지정하면 대부분의 샘플이 포함됩니다.
[in] szUserCaption
로그 파일의 사용자 정의 캡션을 지정하는 Null종료된 문자열입니다. 로그 파일 캡션은 일반적으로 로그 파일의 내용을 설명합니다. 기존 로그 파일을 열면 이 매개 변수의 값이 무시됩니다.
[out] phLog
열린 로그 파일에 대한 핸들입니다.
반환 값
함수가 성공하면 ERROR_SUCCESS 반환합니다.
함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드.
발언
이 함수를 사용하여 성능 데이터를 로그 파일에 쓰려면 이 함수를 호출하기 전에 PdhOpenQuery 사용하여 쿼리를 열고 원하는 카운터를 추가해야 합니다.
최신 운영 체제는 이전 운영 체제에서 생성된 로그 파일을 읽을 수 있습니다. 그러나 Windows Vista 이상 운영 체제에서 만든 로그 파일은 이전 운영 체제에서 읽을 수 없습니다.
로그 파일에 다음 규칙이 적용됩니다.
READ_ACCESS OPEN_EXISTING 필요합니다.
UPDATE_ACCESS 파일 기반 로그와 함께 사용할 수 없습니다. 데이터베이스 로그에만 사용할 수 있습니다.
WRITE_ACCESS CREATE_NEW, CREATE_ALWAYS, OPEN_EXISTING, OPEN_ALWAYS 중 하나가 필요합니다.
예제
예를 들어 로그 파일성능 데이터 쓰기
메모
pdh.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 PdhOpenLog를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | pdh.h |
| 라이브러리 | Pdh.lib |
| DLL | Pdh.dll |
참고 항목
PdhGetLogFileSize