SymSrvStoreSupplement 함수(dbghelp.h)

지정된 보충의 파일을 기호 저장소에 저장합니다. 파일은 일반적으로 기호 서버의 파일과 연결됩니다.

구문

PCSTR IMAGEAPI SymSrvStoreSupplement(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  Node,
  [in]           PCSTR  File,
  [in]           DWORD  Flags
);

매개 변수

[in] hProcess

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

[in, optional] SrvPath

기호 저장소의 경로입니다.

[in] Node

추가 파일과 연결된 기호 파일입니다.

[in] File

파일 이름입니다.

[in] Flags

이 매개 변수가 SYMSTOREOPT_COMPRESS 경우 파일은 기호 저장소에서 압축됩니다. 현재 지원되는 다른 값은 없습니다.

반환 값

함수가 성공하면 반환 값은 보충 파일의 정규화된 경로입니다.

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

설명

이 함수의 중요한 용도는 델타 파일을 저장하는 것입니다. 자세한 내용은 SymSrvDeltaName을 참조하세요.

이 함수는 다른 함수에서 다시 사용할 수 있는 버퍼에 대한 포인터를 반환합니다. 따라서 다른 버퍼에 반환된 데이터를 즉시 복사해야 합니다.

기호 서버는 공통 디렉터리에 동일한 확장자를 가진 추가 파일을 저장합니다. 예를 들어 Sup1.xml SymPath\supplement\Node\xml 디렉터리에 저장됩니다.

저장소 관리자는 사용자가 Supplement라는 저장소의 루트에 읽기 전용 파일을 만들어 추가 파일을 작성하지 못하도록 할 수 있습니다. 또는 관리자가 추가 디렉터리를 만들고 ACL을 사용하여 액세스를 제어할 수 있습니다.

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

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

요구 사항

추가 정보

DbgHelp 함수

SymSrvGetSupplement