Função SccAdd
Esta função adiciona novos arquivos ao sistema de controle de origem.
SCCRTN SccAdd(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG* pfOptions,
LPCMDOPTS pvOptions
);
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 selecionados para serem adicionados ao projeto atual, conforme indicado na lpFileNames array.lpFileNames
[in] Matriz de nomes totalmente qualificados de locais de arquivos a serem adicionados.lpComment
[in] O comentário a ser aplicado a todos os arquivos que está sendo adicionados.pfOptions
[in] Matriz de sinalizadores de comando, fornecidos em uma base por arquivo.pvOptions
[in] Opções de plug-in específico de controle de origem.
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 operação de adição foi bem-sucedida. |
SCC_E_FILEALREADYEXISTS |
O arquivo selecionado já está sob controle de origem. |
SCC_E_TYPENOTSUPPORTED |
Não há suporte para o tipo do arquivo (por exemplo, binário) pelo sistema de controle de origem. |
SCC_E_OPNOTSUPPORTED |
O sistema de controle de origem não oferece suporte para esta operação. |
SCC_E_ACCESSFAILURE |
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_NOTAUTHORIZED |
O usuário não tem permissão para executar esta operação. |
SCC_E_NONSPECIFICERROR |
Falha não específica; Adicione não executada. |
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 |
Não foi encontrado o arquivo local. |
Comentários
Os controles usuais fOptions são substituídos aqui por uma matriz, pfOptions, com um LONG opção especificação por arquivo. Isso ocorre porque o tipo de arquivo pode variar em cada arquivo.
Dica
Não é válido para especificar ambos SCC_FILETYPE_TEXT e SCC_FILETYPE_BINARY opções para o mesmo arquivo, mas ele é válido para especificar que nenhuma delas.A configuração de nenhum deles é igual a configuração SCC_FILETYPE_AUTO, caso em que a fonte de controlar o tipo de arquivo deste detecta automaticamente plug-in.
Abaixo há uma lista de sinalizadores usados na pfOptions matriz:
Opção |
Valor |
Significado |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 |
O plug-in de controle de origem deve detectar o tipo de arquivo. |
SCC_FILETYPE_TEXT |
0x01 |
Indica um arquivo de texto ASCII. |
SCC_FILETYPE_BINARY |
0x02 |
Indica um tipo de arquivo diferente de texto ASCII. |
SCC_ADD_STORELATEST |
0x04 |
Armazena apenas a cópia mais recente do arquivo, não há deltas. |
SCC_FILETYPE_TEXT_ANSI |
0x08 |
Trata o arquivo como texto ANSI. |
SCC_FILETYPE_UTF8 |
0x10 |
Trata o arquivo como texto Unicode no formato UTF8. |
SCC_FILETYPE_UTF16LE |
0x20 |
Trata o arquivo como texto Unicode em UTF16 Little Endian formato. |
SCC_FILETYPE_UTF16BE |
0x40 |
Formato de arquivo como texto Unicode em UTF16 Big Endian trata. |