DeleteLogByHandle 함수(clfsw32.h)

삭제할 지정된 로그를 표시합니다. 로그에 대한 모든 핸들, 마샬링 영역 및 읽기 컨텍스트가 닫혀 있으면 로그가 실제로 삭제됩니다. 로그가 실제 로그인 경우 해당 기본 컨테이너가 삭제됩니다.

로그가 삭제되도록 표시되면 새 클라이언트 로그 스트림 열기 요청이 실패합니다.

참고 이 함수는 로그 이름 대신 유효한 열린 핸들을 로그 개체에 가져가므로 DeleteLogFile과 다릅니다.

구문

CLFSUSER_API BOOL DeleteLogByHandle(
  [in] HANDLE hLog
);

[in] hLog

CreateLogFile을 성공적으로 호출하여 얻은 열린 로그에 대한 핸들입니다. 로그가 DELETE 액세스로 만들어졌어야 합니다. 그렇지 않으면 로그를 삭제할 수 없습니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 다음 목록에서는 가능한 오류 코드를 식별합니다.