Função SccCheckin

Artigo
01/13/2024

Esta função faz check-out de arquivos previamente verificados para o sistema de controle do código-fonte, armazenando as alterações e criando uma nova versão. Essa função é chamada com uma contagem e uma matriz de nomes dos arquivos a serem verificados.

Sintaxe

SCCRTN SccCheckin (
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPSTR*    lpFileNames,
   LPCSTR    lpComment,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

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 SCC pode usar como pai para quaisquer caixas de diálogo que ele forneça.

nArquivos

[em] Número de arquivos selecionados para check-in.

lpFileNames

[em] Matriz de nomes de caminho local totalmente qualificados dos arquivos a serem verificados.

lpComentário

[em] Comentário a ser aplicado a cada um dos arquivos selecionados que estão sendo submetidos a check-in. Esse parâmetro é NULL se o plug-in de controle do código-fonte deve solicitar um comentário.

fOpções

[em] Sinalizadores de comando, 0 ou SCC_KEEP_CHECKEDOUT.

pvOpções

[em] Opções específicas do plug-in SCC.

Valor retornado

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	Foi feito check-in do arquivo com êxito.
SCC_E_FILENOTCONTROLLED	O arquivo selecionado não está sob 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. Recomenda-se uma nova tentativa.
SCC_E_NONSPECIFICERROR	Falha inespecífica. Não foi feito check-in do arquivo.
SCC_E_NOTCHECKEDOUT	O usuário não fez check-out do arquivo, portanto, não pode fazer check-in.
SCC_E_CHECKINCONFLICT	O check-in não pôde ser realizado porque: - Outro usuário fez check-in com antecedência e `bAutoReconcile` foi falso. -ou- - A mesclagem automática não pode ser feita (por exemplo, quando os arquivos são binários).
SCC_E_VERIFYMERGE	O arquivo foi mesclado automaticamente, mas não foi verificado na verificação pendente do usuário.
SCC_E_FIXMERGE	O arquivo foi mesclado automaticamente, mas não foi feito check-in devido a um conflito de mesclagem que deve ser resolvido manualmente.
SCC_E_NOTAUTHORIZED	O usuário não tem permissão para executar essa operação.
SCC_I_OPERATIONCANCELED	A operação foi cancelada antes da conclusão.
SCC_I_RELOADFILE	Um arquivo ou projeto precisa ser recarregado.
SCC_E_FILENOTEXIST	O arquivo local não foi encontrado.

Comentários

O comentário se aplica a todos os arquivos que estão sendo submetidos a check-in. O argumento comment pode ser uma cadeia de caracteres, caso em que o plug-in de controle do código-fonte pode solicitar ao usuário uma null cadeia de caracteres de comentário para cada arquivo.

O fOptions argumento pode receber um valor do sinalizador para indicar a intenção do usuário de fazer check-in do SCC_KEEP_CHECKEDOUT arquivo e check-out novamente.

Confira também

Funções da API do plug-in de controle do código-fonte

Partilhar via