SccGetParentProjectPath 함수

이 함수는 지정된 프로젝트의 부모 프로젝트 경로를 결정합니다. 이 함수는 사용자가 소스 제어에 Visual Studio 프로젝트를 추가할 때 호출됩니다.

구문

SCCRTN SccGetParentProjectPath(
   LPVOID pContext,
   HWND   hWnd,
   LPSTR  lpUser,
   LPCSTR lpProjPath,
   LPSTR  lpAuxProjPath,
   LPSTR  lpParentProjPath
);

매개 변수

pContext

[in] 소스 제어 플러그 인 컨텍스트 포인터입니다.

hWnd

[in] 소스 제어 플러그 인이 제공하는 대화 상자의 부모로 사용할 수 있는 IDE 창에 대한 핸들입니다.

lpUser

[in, out] 사용자 이름(NULL 종결자를 포함하여 최대 SCC_USER_SIZE)입니다.

lpProjPath

[in] 프로젝트 경로를 식별하는 문자열(NULL 종결자를 포함하여 최대 SCC_PRJPATH_SIZE)입니다.

lpAuxProjPath

[in, out] 프로젝트를 식별하는 보조 문자열(NULL 종결자를 포함하여 최대 SCC_PRJPATH_SIZE)입니다.

lpParentProjPath

[in] 부모 프로젝트 경로를 식별하는 출력 문자열(NULL 종결자를 포함하여 최대 SCC_PRJPATH_SIZE)입니다.

반환 값

이 함수의 소스 제어 플러그 인 구현은 다음 값 중 하나를 반환해야 합니다.

설명

이 함수는 성공 또는 실패 코드를 반환하고, 성공하면 지정된 프로젝트에 대한 전체 프로젝트 경로로 lpParentProjPath 변수를 채웁니다.

이 함수는 기존 프로젝트의 부모 프로젝트 경로를 반환합니다. 루트 프로젝트의 경우 함수는 전달된 프로젝트 경로(즉, 동일한 루트 프로젝트 경로)를 반환합니다. 프로젝트 경로는 소스 제어 플러그 인에만 의미 있는 문자열입니다.

IDE는 lpUser 및 lpAuxProjPath 매개 변수에 대한 변경 내용도 수락할 준비가 되어 있습니다. IDE는 이러한 문자열을 유지하다가 사용자가 나중에 이 프로젝트를 열 때 SccOpenProject에 전달합니다. 따라서 이러한 문자열은 소스 제어 플러그 인이 프로젝트와 연결하는 데 필요한 정보를 추적하는 방법을 제공합니다.

이 함수는 사용자에게 프로젝트를 선택하라는 메시지를 표시하지 않는다는 점을 제외하고 SccGetProjPath와 유사합니다. 또한 새 프로젝트를 만들지 않고 기존 프로젝트에서만 작동합니다.

SccGetParentProjectPath가 호출되면 lpProjPath 및 lpAuxProjPath는 비어 있지 않으며 유효한 프로젝트에 해당합니다. 이러한 문자열은 일반적으로 IDE가 이전의 SccGetProjPath 함수 호출에서 수신합니다.

lpUser 인수는 사용자 이름입니다. IDE는 이전에 SccGetProjPath 함수에서 수신한 것과 동일한 사용자 이름을 전달하며 소스 제어 플러그 인은 이 이름을 기본값으로 사용해야 합니다. 사용자가 이미 플러그 인과 연결된 경우 플러그 인은 함수가 자동으로 작동하는지 확인하기 위해 프롬프트를 제거하려고 시도해야 합니다. 그러나 로그인에 실패하면 플러그 인은 사용자에게 로그인을 요청하고 유효한 로그인을 수신하면 lpUser에 이름을 다시 전달해야 합니다. 플러그 인이 이 문자열을 변경할 수 있으므로 IDE는 항상 버퍼 크기(SCC_USER_LEN+1)를 할당합니다. 문자열이 변경된 경우 새 문자열은 유효한 로그인 이름이어야 합니다(적어도 이전 문자열만큼 유효함).

SccCreateSubProject 및 SccGetParentProjectPath에 대한 기술 참고 사항

Visual Studio에서 소스 제어에 솔루션 및 프로젝트 추가가 사용자에게 소스 제어 시스템에서 위치를 선택하라는 메시지가 표시되는 횟수를 최소화하도록 간소화되었습니다. 소스 제어 플러그 인이 새 함수인 SccCreateSubProject 및 SccGetParentProjectPath 함수를 모두 지원하는 경우 Visual Studio가 이러한 변경 내용을 활성화합니다. 그러나 다음 레지스트리 항목을 사용하여 이러한 변경 내용을 사용하지 않도록 설정하고 이전 Visual Studio(소스 제어 플러그 인 API 버전 1.1) 동작으로 되돌릴 수 있습니다.

[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\8.0\SourceControl] "DoNotCreateSolutionRootFolderInSourceControl"=dword:00000001

이 레지스트리 항목이 없거나 dword:000000000으로 설정된 경우 Visual Studio는 새 함수 SccCreateSubProject 및 SccGetParentProjectPath를 사용하려고 시도합니다.

레지스트리 항목이 dword:00000001로 설정된 경우 Visual Studio는 이러한 새 함수를 사용하려고 시도하지 않고, 소스 제어에 추가 작업이 이전 버전의 Visual Studio에서와 같이 작동합니다.

참고 항목

• 소스 제어 플러그 인 API 함수
• SccCreateSubProject
• SccGetProjPath