Função SccDirDiff

Artigo
01/13/2024

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.

Confira também

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

Partilhar via