AddLogContainer 함수(clfsw32.h)
호출 프로세스에 .blf 파일에 대한 쓰기 액세스 권한이 있고 컨테이너의 대상 디렉터리에 파일을 만드는 기능이 있는 경우 로그 핸들과 연결된 실제 로그에 컨테이너를 추가합니다.
이 함수는 컨테이너를 하나만 추가하기 때문에 AddLogContainerSet와 다릅니다. 여러 컨테이너를 추가하려면 둘 이상의 컨테이너를 추가할 수 있는 AddLogContainerSet를 사용하는 것이 더 효율적입니다. 컨테이너를 추가하면 클라이언트가 로그 크기를 늘릴 수 있습니다.
구문
CLFSUSER_API BOOL AddLogContainer(
[in] HANDLE hLog,
[in, optional] PULONGLONG pcbContainer,
[in] LPWSTR pwszContainerPath,
[in, out, optional] LPVOID pReserved
);
매개 변수
[in] hLog
열린 로그에 대한 핸들입니다.
로그에 대한 쓰기 권한이 있는 CreateLogFile 에서 핸들을 가져와야 합니다. 클라이언트 애플리케이션은 .blf 파일에 대한 쓰기 액세스 권한과 컨테이너의 대상 디렉터리에 파일을 만들 수 있어야 합니다.
[in, optional] pcbContainer
컨테이너의 크기를 바이트 단위로 지정하는 선택적 매개 변수입니다.
최소 크기는 일반 로그의 경우 512KB, 멀티플렉싱 로그의 경우 1024KB입니다. 최대 크기는 약 4기가바이트입니다.
컨테이너가 새로 만든 로그에 추가되는 경우 이 매개 변수가 필요합니다. 컨테이너가 이미 만들어진 경우 이 매개 변수는 NULL이거나 첫 번째 컨테이너의 크기만큼 큰 일부 값일 수 있습니다.
로그 컨테이너 크기는 로그 지역 크기(512KB)의 배수입니다. 새 파일에 컨테이너를 추가하면 AddLogContainer 함수는 컨테이너의 크기를 다음 512KB 경계까지 반올림하고 pcbContainer가 가리키는 값으로 해당 크기를 반환합니다.
마찬가지로 로그에 이미 하나 이상의 컨테이너가 있고 *pcbContainer 값이 현재 컨테이너 크기만큼 큰 경우 함수는 현재 내부 크기로 모든 컨테이너를 만들고 해당 크기를 *pcbContainer로 반환합니다.
[in] pwszContainerPath
로그 볼륨의 새 컨테이너에 대한 유효한 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[in, out, optional] pReserved
예약되어 있습니다. pReserved를 NULL로 설정합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
다음 목록에서는 가능한 오류 코드를 식별합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |