PdhVbOpenLog 함수
PdhVbOpenLog 함수는 읽기 및 쓰기를 위해 지정된 로그 파일을 엽니다. 이 함수는 PdhOpenLog를 호출합니다.
중요
이 항목에서 설명하는 함수는 나중에 변경되거나 사용할 수 없습니다. 대신 성능 카운터 함수에 설명된 함수를 사용하는 것이 좋습니다.
함수 PdhVbOpenLog( _ ByVal szLogFileName As LPCTSTR, _ ByVal dwAccessFlags As DWORD, _ ByVal lpdwLogType As LPDWORD, _ ByVal hQuery As PDH_HQUERY, _ ByVal dwMaxSize as DWORD, _ ByVal szUserCaption as LPCSTR, _ ByRef phLog As PDH_HLOG _ ) As DWORD
매개 변수
-
szLogFileName [in]
-
열 로그 파일의 이름을 지정하는 문자열에 대한 포인터입니다.
로그 파일에 SQL 데이터가 포함된 경우 로그 파일의 이름 형식은 **SQL:DataSourceName!**LogFileName입니다. 이 경우 lpdwLogType 매개 변수의 값은 PDH_LOG_TYPE_SQL.
-
dwAccessFlags [in]
-
로그 파일을 열 때 지정할 액세스 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 의미 - PDH_LOG_READ_ACCESS
읽기 작업을 위해 로그 파일이 열립니다. - PDH_LOG_WRITE_ACCESS
쓰기 작업을 위해 새 로그 파일이 열립니다. - PDH_LOG_UPDATE_ACCESS
쓰기 작업을 위해 기존 로그 파일이 열립니다. 이전 테이블에서 선택한 값은 다음 만들기 액세스 플래그 중 하나와 함께 OR 연산자를 사용하여 결합할 수 있습니다.
값 의미 - PDH_LOG_CREATE_NEW
지정된 이름의 새 로그 파일이 만들어집니다. - PDH_LOG_CREATE_ALWAYS
지정된 이름의 새 로그 파일이 만들어지고 이름이 같은 기존 로그 파일이 지워집니다. - PDH_LOG_OPEN_EXISTING
지정된 이름의 기존 로그 파일이 열립니다. 지정된 이름의 로그 파일이 없으면 이 파일은 PDH_LOG_CREATE_NEW 같습니다. - PDH_LOG_OPEN_ALWAYS
지정된 이름의 기존 로그 파일이 열리거나 지정된 이름의 새 로그 파일이 만들어집니다. -
lpdwLogType [in]
-
열 로그 파일의 형식을 나타내는 변수에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 의미 - PDH_LOG_TYPE_UNDEFINED
정의되지 않은 로그 파일 형식입니다. - PDH_LOG_TYPE_CSV
첫 번째 줄의 열 머리글과 각 후속 줄의 개별 데이터 샘플이 포함된 텍스트 파일입니다. - PDH_LOG_TYPE_SQL
로그 파일의 데이터는 SQL에 있습니다. - PDH_LOG_TYPE_TSV
PDH_LOG_TYPE_CSV 동일합니다. - PDH_LOG_TYPE_BINARY
이진 로그 파일 형식입니다. 순환 로그 파일을 포함합니다. - PDH_LOG_TYPE_PERFMON
Perfmon 로그 파일 형식입니다. -
hQuery [in]
-
쿼리 핸들입니다. 이 핸들은 PdhVbOpenQuery 함수에 의해 반환됩니다.
로그 파일을 읽기 위해 열면 이 매개 변수는 NULL 일 수 있습니다.
-
dwMaxSize [in]
-
로그 파일의 최대 크기(바이트)입니다. 이 값은 로그 파일이 제한된 크기 또는 순환 로그 파일인 경우에만 사용됩니다.
-
szUserCaption [in]
-
로그 파일의 사용자 정의 캡션 지정하는 문자열에 대한 포인터입니다. 로그 파일 캡션 일반적으로 로그 파일의 내용을 설명합니다. 기존 로그 파일을 열면 이 매개 변수의 값이 무시됩니다.
-
phLog [in, ref]
-
열린 로그 파일에 대한 핸들을 받는 버퍼에 대한 포인터입니다.
반환 값
함수가 성공하면 0을 반환합니다.
함수가 실패하면 반환 값은 시스템 오류 코드 또는 PDH 오류 코드입니다. 가능한 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
요청된 데이터가 제공된 버퍼보다 큽 수 있습니다. 요청된 데이터를 반환할 수 없습니다. |
|
하나 이상의 문자열 버퍼가 올바른 크기가 아닙니다. |
|
이 핸들은 올바른 PDH 개체가 아닙니다. |
|
지정된 로그 파일을 열 수 없습니다. |
|
지정된 파일을 찾을 수 없습니다. |
설명
이 함수를 사용하여 성능 데이터를 로그 파일에 쓰는 경우 먼저 PdhVbOpenQuery를 사용하여 쿼리를 열어야 합니다.
이 함수가 호출되기 전에 현재 열려 있는 쿼리가 있어야 하고 원하는 카운터를 추가해야 합니다.
Perfmon 형식의 로그 파일은 읽기 전용으로 열 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 라이브러리 |
|
| DLL |
|