GetLogFileInformation 함수(clfsw32.h)
지정된 로그 및 CLFS_INFORMATION 구조체 에 의해 정의된 현재 상태에 대한 메타데이터가 포함된 버퍼를 반환합니다.
가져온 데이터는 호출이 이루어진 시간에만 로그의 상태를 반영합니다. 일반적으로 클라이언트는 레코드를 추가하거나 다시 시작 영역을 작성할 때까지 이 구조체의 필드를 계속 캐시하고 사용할 수 있습니다. 이때 일부 정보는 부실해집니다.
구문
CLFSUSER_API BOOL GetLogFileInformation(
[in] HANDLE hLog,
[in, out] PCLFS_INFORMATION pinfoBuffer,
[in, out] PULONG cbBuffer
);
매개 변수
[in] hLog
CreateLogFile에 대한 성공적인 호출에서 가져온 열린 로그에 대한 핸들입니다.
로그 핸들은 전용 또는 멀티플렉싱 로그를 참조할 수 있습니다.
[in, out] pinfoBuffer
로그 메타데이터를 수신하는 사용자가 할당한 CLFS_INFORMATION 구조체에 대한 포인터입니다.
[in, out] cbBuffer
입력 시 pinfoBuffer가 가리키는 메타데이터 버퍼의 크기(바이트)를 지정하는 변수에 대한 포인터입니다.
출력에서 실제로 pinfoBuffer에 복사되는 바이트 수를 지정합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
다음 목록에서는 가능한 오류 코드를 식별합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |