Função SccDirDiff
Essa função exibe as diferenças entre o diretório local atual no disco do cliente e o projeto correspondente sob controle do código-fonte.
Sintaxe
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parâmetros
pContext
[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.
lpDirName
[em] Caminho totalmente qualificado para o diretório local para o qual mostrar uma diferença visual.
dwFlags
[em] Sinalizadores de comando (consulte a seção Comentários).
pvOpções
[em] Opções específicas do plug-in de controle do código-fonte.
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 | O diretório no disco é o mesmo que o projeto no controle do código-fonte. |
| SCC_I_FILESDIFFER | O diretório no disco é diferente do projeto no controle do código-fonte. |
| SCC_I_RELOADFILE | Um arquivo ou projeto precisa ser recarregado. |
| SCC_E_FILENOTCONTROLLED | O diretório não está sob controle do código-fonte. |
| SCC_E_NOTAUTHORIZED | O usuário não tem permissão para executar essa operação. |
| 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 SCC_E_UNKNOWNERROR |
Falha inespecífica. |
| SCC_E_FILENOTEXIST | Não foi possível encontrar o diretório local. |
Comentários
Essa função é usada para instruir o plug-in de controle do código-fonte a exibir ao usuário uma lista de alterações em um diretório especificado. O plug-in abre sua própria janela, em um formato de sua escolha, para exibir as diferenças entre o diretório do usuário no disco e o projeto correspondente sob controle de versão.
Se um plug-in suportar a comparação de diretórios, ele deverá oferecer suporte à comparação de diretórios com base no nome do arquivo, mesmo que as opções de "comparação rápida" não sejam suportadas.
dwFlags |
Interpretação |
|---|---|
| SCC_DIFF_IGNORECASE | Comparação sem distinção entre maiúsculas e minúsculas (pode ser usada para comparação rápida ou visual). |
| SCC_DIFF_IGNORESPACE | Ignora o espaço em branco (pode ser usado para comparação rápida ou visual). |
| SCC_DIFF_QD_CONTENTS | Se suportado pelo plug-in de controle do código-fonte, compara silenciosamente o diretório, byte por byte. |
| SCC_DIFF_QD_CHECKSUM | Se suportado pelo plug-in, compara silenciosamente o diretório por meio de uma soma de verificação ou, se não for suportado, retorna para SCC_DIFF_QD_CONTENTS. |
| SCC_DIFF_QD_TIME | Se suportado pelo plug-in, compara silenciosamente o diretório por meio de seu carimbo de data/hora ou, se não for suportado, recorre a SCC_DIFF_QD_CHECKSUM ou SCC_DIFF_QD_CONTENTS. |
Observação
Essa função usa os mesmos sinalizadores de comando que o SccDiff. No entanto, um plug-in de controle de origem pode optar por não oferecer suporte à operação de "comparação rápida" para diretórios.