GetLogContainerName 함수(clfsw32.h)
지정된 컨테이너의 전체 경로 이름을 검색합니다. 이 함수는 주로 ScanLogContainers 호출에서 반환되는 CLFS_CONTAINER_INFORMATION 구조에서 참조되는 컨테이너의 전체 경로 이름을 가져오는 데 사용됩니다.
구문
CLFSUSER_API BOOL GetLogContainerName(
[in] HANDLE hLog,
[in] CLFS_CONTAINER_ID cidLogicalContainer,
[in, out] LPCWSTR pwstrContainerName,
[in] ULONG cLenContainerName,
[in, out, optional] PULONG pcActualLenContainerName
);
매개 변수
[in] hLog
CreateLogFile에 대한 성공적인 호출에서 가져온 로그에 대한 핸들입니다.
로그 핸들은 로그 스트림 또는 실제 로그를 참조할 수 있습니다.
[in] cidLogicalContainer
컨테이너와 연결된 고유 식별자입니다.
[in, out] pwstrContainerName
로그 컨테이너의 전체 경로와 이름을 와이드 문자로 수신하는 사용자 할당 버퍼에 대한 포인터입니다.
[in] cLenContainerName
pwstrContainerName이 가리키는 버퍼의 크기(문자)입니다.
[in, out, optional] pcActualLenContainerName
검색되는 전체 컨테이너 경로 이름의 실제 문자 수를 받는 변수에 대한 포인터입니다.
함수가 성공하면 이 매개 변수의 값이 cLenContainerName보다 작거나 같습니다. 버퍼가 전체 컨테이너 경로 이름을 저장할 만큼 크지 않은 경우 함수는 ERROR_MORE_DATA 실패하고 이 매개 변수를 전체 경로 이름에 필요한 크기로 설정합니다. 다른 오류의 경우 값이 정의되지 않았습니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 다음 목록에서는 가능한 오류 코드를 식별합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | clfsw32.h |
| 라이브러리 | Clfsw32.lib |
| DLL | Clfsw32.dll |