Função SccDirDiff
Esta função exibe as diferenças entre o diretório local atual do disco do cliente e o projeto sob controle de origem correspondente.
SCCRTN SccDirDiff(
LPVOID pContext,
HWND hWnd,
LPCSTR lpDirName,
LONG dwFlags,
LPCMDOPTS pvOptions
);
Parâmetros
pContext
[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.lpDirName
[in] Caminho totalmente qualificado para o diretório local para o qual deseja mostrar uma diferença visual.dwFlags
[in] Sinalizadores de comando (consulte os comentários seção).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 |
O diretório no disco é o mesmo que o projeto no controle de código fonte. |
SCC_I_FILESDIFFER |
O diretório no disco é diferente do projeto no controle de código fonte. |
SCC_I_RELOADFILE |
Um arquivo ou projeto precisa ser recarregado. |
SCC_E_FILENOTCONTROLLED |
O diretório não está sob controle de código fonte. |
SCC_E_NOTAUTHORIZED |
O usuário não tem permissão para executar 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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Falha de não-específica. |
SCC_E_FILENOTEXIST |
Diretório local não pôde ser encontrado. |
Comentários
Essa função é usada para instruir o plug-in para exibir a uma lista de alterações para um diretório especificado para o usuário de controle de origem. O plug-in abre sua própria janela, em um formato de sua preferência, para exibir as diferenças entre o diretório do usuário no disco e o projeto sob controle de versão correspondente.
Se uma comparação de suporta plug-in de diretórios em todos, ele deve oferecer suporte a comparação de diretórios em uma base do nome do arquivo mesmo se não há suporte para as opções "quick-diff".
dwFlags |
Interpretação |
|---|---|
SCC_DIFF_IGNORECASE |
Comparação entre maiúsculas e minúsculas (pode ser usado para comparação rápida ou visual). |
SCC_DIFF_IGNORESPACE |
Ignora espaços em branco (pode ser usado para comparação de rápida ou visual). |
SCC_DIFF_QD_CONTENTS |
Se o suporte a plug-in de controle de origem, silenciosamente compara o diretório, byte por byte. |
SCC_DIFF_QD_CHECKSUM |
Se suportado pelo plug-in, silenciosamente compara o diretório por meio de uma soma de verificação ou, se não houver suporte, volta ao SCC_DIFF_QD_CONTENTS. |
SCC_DIFF_QD_TIME |
Se suportado pelo plug-in, silenciosamente compara o diretório por meio de seu carimbo de hora ou, se não houver suporte, volta em SCC_DIFF_QD_CHECKSUM ou SCC_DIFF_QD_CONTENTS. |
Dica
Essa função usa os mesmos sinalizadores de comando, como o Função SccDiff.No entanto, um plug-in de controle de origem pode optar por não oferece suporte à operação de "quick-diff" para diretórios.