RemoveLogContainer 함수(clfsw32.h)
전용 또는 멀티플렉싱된 로그 핸들과 연결된 로그에서 하나의 컨테이너를 제거합니다.
클라이언트는 컨테이너를 제거하려면 로그 핸들에 대한 관리 권한이 있어야 합니다. 여러 컨테이너를 제거하려면 RemoveLogContainerSet 함수를 사용합니다.
구문
CLFSUSER_API BOOL RemoveLogContainer(
[in] HANDLE hLog,
[in] LPWSTR pwszContainerPath,
[in] BOOL fForce,
[in, out, optional] LPVOID pReserved
);
매개 변수
[in] hLog
CreateLogFile에서 가져온 로그에 대한 핸들입니다.
[in] pwszContainerPath
AddLogContainer 또는 AddLogContainerSet에서 만든 로그 컨테이너의 경로를 포함하는 와이드 문자열에 대한 포인터입니다.
[in] fForce
컨테이너가 삭제되는 시기와 방법을 결정하는 삭제 플래그입니다.
fForce가 TRUE이고 컨테이너가 활성 로그 영역의 일부인 경우 컨테이너가 삭제되지 않고 오류 ERROR_LOG_CANT_DELETE 반환됩니다.
FALSE이면 컨테이너가 더 이상 활성 로그 영역의 일부가 아니면 컨테이너가 삭제됩니다.
[in, out, optional] pReserved
이 매개 변수는 예약되어 있으며 NULL로 설정해야 합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
다음 목록에서는 가능한 오류 코드를 식별합니다.
설명
기본적으로 컨테이너 삭제는 지연입니다. 즉, 컨테이너가 활성 로그의 일부가 아닌 경우에만 삭제됩니다. 컨테이너가 활성 로그의 일부인 경우 삭제로 표시됩니다. 그러나 로그의 끝이 컨테이너의 마지막 섹터를 초과하거나 컨테이너에 활성 로그 헤드의 논리적 식별자보다 큰 논리 식별자가 있기 전까지는 삭제가 발생하지 않습니다. 로그 크기는 컨테이너가 물리적으로 삭제된 경우에만 컨테이너 삭제를 반영합니다.
로그 클라이언트는 삭제 플래그를 TRUE로 설정하여 컨테이너에서 강제 삭제를 요청할 수 있습니다. 활성 로그의 일부가 아닌 컨테이너를 삭제하는 것과 동일한 효과가 있습니다. 그러나 컨테이너가 활성 로그의 일부인 경우 삭제할 컨테이너를 표시하지 않고 호출이 실패합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |