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