Partilhar via


Função SccRunScc

Esta função chama a ferramenta de administração de controle de origem.

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

Parâmetros

  • pvContext
    [in] A estrutura de contexto de plug-in de controle de origem.

  • hWnd
    [in] Um identificador para a janela do IDE que o plug-in de controle de origem pode usar como um pai para as caixas de diálogo que ele fornece.

  • nFiles
    [in] Número de arquivos especificados no lpFileNames array.

  • lpFileNames
    [in] Matriz de nomes de arquivo selecionado.

Valor de retorno

A implementação de plug-in de controle de origem dessa função deve retornar um dos seguintes valores:

Valor

Descrição

SCC_OK

A ferramenta de administração de controle de origem foi chamada com sucesso.

SCC_I_OPERATIONCANCELED

A operação foi cancelada.

SCC_E_INITIALIZEFAILED

Falha ao inicializar o sistema de controle de origem.

SCC_E_ACCESSFAILURE

Houve um problema ao acessar o sistema de controle de origem, provavelmente devido a problemas de rede ou contenção.

SCC_E_CONNECTIONFAILURE

Falha ao conectar-se ao sistema de controle de origem.

SCC_E_FILENOTCONTROLLED

O arquivo selecionado não está sob controle de origem.

SCC_E_NONSPECIFICERROR

Falha de não-específica.

Comentários

Essa função permite que o chamador acessar toda a gama de recursos do sistema de controle de origem por meio de uma ferramenta de administração externa. Se o sistema de controle de origem tiver sem interface do usuário, o plug-in de controle de origem pode implementar uma interface para executar funções administrativas necessárias.

Esta 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 for compatível, a lista de arquivos pode ser usada para pré-selecionar os arquivos na interface de administração; Caso contrário, a lista pode ser ignorada.

Essa função normalmente é chamado quando o usuário seleciona o lançamento < servidor de controle de origem > da arquivo -> Controle de fonte de menu. Isso Iniciar opção de menu pode ser sempre desabilitada ou até mesmo ocultada, definindo uma entrada do registro. Para obter detalhes, consulte:Como: instalar um plug-in de controle de origem Esta função é chamada somente se Função SccInitialize retorna o SCC_CAP_RUNSCC bit de recurso (consulte Sinalizadores de recurso para obter detalhes sobre este e outros bits de funcionalidade).

Consulte também

Referência

Função SccInitialize

Conceitos

Funções de API plug-in de controle de origem

Como: instalar um plug-in de controle de origem

Sinalizadores de recurso