Códigos de erro
Quando uma função da API de plug-in de controle de origem retorna um erro, ele deve ser um dos seguintes códigos de erro. Todos os erros são negativos, avisos ou códigos de erro informativas são positivos, e o sucesso é 0.
Código de erro |
Valor |
Descrição |
|---|---|---|
SCC_I_SHARESUBPROJOK |
7 |
Plug-in oferece suporte à adição de arquivos do controle de origem em duas etapas. Para obter mais informações, consulte Função SccSetOption. |
SCC_I_FILEDIFFERS |
6 |
O arquivo local é diferente do arquivo do banco de dados de controle de origem (por exemplo, Função SccDiff pode retornar esse valor). |
SCC_I_RELOADFILE |
5 |
Arquivo local foi alterado durante a operação de controle de origem; o IDE deve recarregar o arquivo se possível. |
SCC_I_FILENOTAFFECTED |
4 |
O arquivo não é afetado. |
SCC_I_PROJECTCREATED |
3 |
O projeto foi criado durante a operação de controle de origem (por exemplo, durante uma chamada para Função SccOpenProject quando SCC_OP_CREATEIFNEW sinalizador for especificado). |
SCC_I_OPERATIONCANCELED |
2 |
Operação foi cancelada. |
SCC_I_ADV_SUPPORT |
1 |
Plug-in oferece suporte a opções avançadas para o comando especificado. Para obter mais informações, consulte Função SccGetCommandOptions. |
SCC_OK |
0 |
Sucesso. |
SCC_E_INITIALIZEFAILED |
-1 |
Erro: Falha na inicialização. |
SCC_E_UNKNOWNPROJECT |
-2 |
Erro: o projeto é desconhecido. |
SCC_E_COULDNOTCREATEPROJECT |
-3 |
Erro: não foi possível criar o projeto. |
SCC_E_NOTCHECKEDOUT |
-4 |
Erro: o arquivo não foi extraído. |
SCC_E_ALREADYCHECKEDOUT |
-5 |
Erro: o arquivo já foi extraído. |
SCC_E_FILEISLOCKED |
-6 |
Erro: o arquivo está bloqueado. |
SCC_E_FILEOUTEXCLUSIVE |
-7 |
Erro: o arquivo exclusivamente check-out. |
SCC_E_ACCESSFAILURE |
-8 |
Houve um problema ao acessar o sistema de controle de origem, provavelmente devido a problemas de rede ou contenção. Recomenda-se uma nova tentativa. |
SCC_E_CHECKINCONFLICT |
-9 |
Erro: Houve um conflito durante o check-in. |
SCC_E_FILEALREADYEXISTS |
-10 |
Erro: o arquivo já existe. |
SCC_E_FILENOTCONTROLLED |
-11 |
Erro: o arquivo não está sob controle de origem. |
SCC_E_FILEISCHECKEDOUT |
-12 |
Erro: o arquivo foi extraído. |
SCC_E_NOSPECIFIEDVERSION |
-13 |
Erro: não há nenhuma versão especificada. |
SCC_E_OPNOTSUPPORTED |
-14 |
Erro: não há suporte para a operação. |
SCC_E_NONSPECIFICERROR |
-15 |
Erro não específico. |
SCC_E_OPNOTPERFORMED |
-16 |
Erro, a operação não foi executado. |
SCC_E_TYPENOTSUPPORTED |
-17 |
Erro: o tipo do arquivo, por exemplo, binário, não é suportado pelo sistema de controle de código fonte. |
SCC_E_VERIFYMERGE |
-18 |
Arquivo tenha sido mesclados para auto, mas não tiver sido verificado porque ele é verificado pelo usuário pendente. |
SCC_E_FIXMERGE |
-19 |
Arquivo tenha sido mesclados para auto, mas não tiver sido incluído devido a um conflito de mesclagem deve ser resolvido manualmente. |
SCC_E_SHELLFAILURE |
-20 |
Erro devido a uma falha de shell. |
SCC_E_INVALIDUSER |
-21 |
Erro: o usuário é inválido. |
SCC_E_PROJECTALREADYOPEN |
-22 |
Erro: o projeto já está aberto. |
SCC_E_PROJSYNTAXERR |
-23 |
Erro de sintaxe do projeto. |
SCC_E_INVALIDFILEPATH |
-24 |
Erro: o caminho do arquivo é inválido. |
SCC_E_PROJNOTOPEN |
-25 |
Erro: o projeto não estiver aberto. |
SCC_E_NOTAUTHORIZED |
-26 |
Erro: o usuário não está autorizado para executar esta operação. |
SCC_E_FILESYNTAXERR |
-27 |
Erro de sintaxe do arquivo. |
SCC_E_FILENOTEXIST |
-28 |
Erro, o arquivo local não existe. |
SCC_E_CONNECTIONFAILURE |
-29 |
Erro: Houve uma falha de conexão. |
SCC_E_UNKNOWNERROR |
-30 |
Erro desconhecido. |
SCC_E_BACKGROUNDGETINPROGRESS |
-31 |
Operação de obtenção de plano de fundo está atualmente em andamento. |
Macros fornecidas para verificação rápida
IS_SCC_ERROR(rtn) (((rtn) < 0) ? TRUE : FALSE)
IS_SCC_SUCCESS(rtn) (((rtn) == SCC_OK) ? TRUE : FALSE)
IS_SCC_WARNING(rtn) (((rtn) > 0) ? TRUE : FALSE)
Comentários
Todas as funções da API de plug-in de controle de origem (exceto o Função SccAdd, Função SccCheckin, e Função SccDiff) é esperado que são bem-sucedidas quando os arquivos locais que são passados como argumentos não existem na pasta de trabalho. Por exemplo, o IDE pode emitir uma chamada para o Função SccCheckout ou Função SccUncheckout em um arquivo que não existe na pasta de trabalho, mas existe no sistema de controle de origem. Essa chamada daria certo. Somente quando não há nenhum arquivo na pasta de trabalho ou no sistema de controle de origem é a função espera falhe.
Determinadas funções, tais como SccAdd e SccCheckin, especificamente deve retornar SCC_E_FILENOTEXIST quando o arquivo na pasta de trabalho não existe. Outras funções devem ter êxito quando o arquivo de trabalho não existe, se as funções operam em um nome de arquivo válido no sistema de controle de origem.
O plug-in de controle de origem deve fazer suposições sobre privilégios em um arquivo na pasta de trabalho, mesmo se o plug-in tinha marcado o arquivo somente leitura durante algumas operações. Um arquivo na pasta de trabalho pode ser movido, excluído e alterado fora de controle do plug-in.