SymSetHomeDirectory 함수(dbghelp.h)

Dbghelp에서 사용하는 홈 디렉터리를 설정합니다.

구문

PCHAR IMAGEAPI SymSetHomeDirectory(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  dir
);

[in] hProcess

프로세스에 대한 핸들입니다. 이 핸들은 이전에 SymInitialize 함수에 전달되어야 합니다.

[in, optional] dir

홈 디렉터리입니다. 이 디렉터리를 쓸 수 있어야 합니다. 그렇지 않으면 홈 디렉터리가 CSIDL_COMMON_APPDATA 지정된 일반적인 애플리케이션 디렉터리입니다. 이 매개 변수가 NULL이면 함수는 기본 디렉터리를 사용합니다.

함수가 성공하면 반환 값은 dir 매개 변수에 대한 포인터입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

기본 홈 디렉터리가 Dbghelp.dll 있는 디렉터리입니다. Dbghelp는 기본 다운스트림 저장소 디렉터리(홈 디렉터리의 sym 하위 디렉터리)와 같은 다른 디렉터리의 기준으로 이 디렉터리를 사용합니다.

기본 기호 저장소 및 원본 서버 캐시 위치에 사용되는 홈 디렉터리가 DBGHELP_HOMEDIR 환경 변수에 저장됩니다.

이 함수와 같은 모든 DbgHelp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.

이 함수의 유니코드 버전을 호출하려면 DBGHELP_TRANSLATE_TCHAR 정의합니다.