Função SccRunScc

  • Artigo

Essa função invoca a ferramenta de administração do controle do código-fonte.

Sintaxe

SCCRTN SccRunScc(
   LPVOID  pvContext,
   HWND    hWnd,
   LONG    nFiles,
   LPCSTR* lpFileNames
);

Parâmetros

pvContexto

[em] A estrutura de contexto do plug-in de controle do código-fonte.

hWnd

[em] Um identificador para a janela do IDE que o plug-in de controle do código-fonte pode usar como pai para quaisquer caixas de diálogo que ele forneça.

nArquivos

[em] Número de arquivos especificados na lpFileNames matriz.

lpFileNames

[em] Matriz de nomes de arquivo selecionados.

Valor de retorno

Espera-se que a implementação do plug-in de controle do código-fonte dessa função retorne um dos seguintes valores:

Valor Descrição
SCC_OK A ferramenta de administração do controle do código-fonte foi invocada com êxito.
SCC_I_OPERATIONCANCELED A operação foi cancelada.
SCC_E_INITIALIZEFAILED Falha ao inicializar o sistema de controle do código-fonte.
SCC_E_ACCESSFAILURE Houve um problema ao acessar o sistema de controle do código-fonte, provavelmente devido a problemas de rede ou contenção.
SCC_E_CONNECTIONFAILURE Falha ao se conectar ao sistema de controle do código-fonte.
SCC_E_FILENOTCONTROLLED O arquivo selecionado não está sob controle do código-fonte.
SCC_E_NONSPECIFICERROR Falha inespecífica.

Comentários

Esta função permite que o chamador acesse toda a gama de recursos do sistema de controle do código-fonte através de uma ferramenta de administração externa. Se o sistema de controle do código-fonte não tiver interface de usuário, o plug-in de controle do código-fonte poderá implementar uma interface para executar as funções de administração necessárias.

Essa função é chamada com uma contagem e uma matriz de nomes de arquivo para os arquivos selecionados no momento. Se a ferramenta de administração o suportar, a lista de arquivos pode ser usada para pré-selecionar arquivos na interface de administração; caso contrário, a lista pode ser ignorada.

Essa função normalmente é invocada quando o usuário seleciona o Launch <Source Control Server> no menu File ->Source Control . Esta opção do menu Iniciar pode ser sempre desativada ou até mesmo oculta definindo uma entrada do Registro. Consulte Como: Instalar um plug-in de controle de origem para obter detalhes. Essa função será chamada somente se SccInitialize retornar o SCC_CAP_RUNSCC bit de capacidade (consulte Sinalizadores de capacidade para obter detalhes sobre esse e outros bits de capacidade).

Confira também