Partilhar via

Função SccUncheckout

  • Artigo

Essa função desfaz uma operação de check-out anterior, restaurando assim o conteúdo do arquivo ou arquivos selecionados para o estado anterior ao check-out. Todas as alterações feitas no arquivo desde o check-out são perdidas.

Sintaxe

SCCRTN SccUncheckout (
   LPVOID    pvContext,
   HWND      hWnd,
   LONG      nFiles,
   LPCSTR*   lpFileNames,
   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 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 caminho local totalmente qualificados de arquivos para os quais desfazer um check-out.

fOpções

[em] Sinalizadores de comando (não usados).

pvOpções

[em] Opções específicas do plug-in de controle do código-fonte.

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 Desfazer checkout foi bem-sucedido.
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. Desfazer checkout não foi bem-sucedido.
SCC_E_NOTCHECKEDOUT O usuário não tem o arquivo com check-out.
SCC_E_NOTAUTHORIZED O usuário não tem permissão para executar essa operação.
SCC_E_PROJNOTOPEN O projeto não foi aberto a partir do controle do código-fonte.
SCC_I_OPERATIONCANCELED A operação foi cancelada antes da conclusão.

Comentários

Após essa operação, os sinalizadores e SCC_STATUS_MODIFIED serão limpos para os SCC_STATUS_CHECKEDOUT arquivos nos quais o checkout de desfazer foi executado.

Confira também