Função SccHistory
Esta função exibe o histórico dos arquivos especificados.
SCCRTN SccHistory(
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LONG fOptions,
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 especificados no lpFileName array.lpFileName
[in] Matriz de nomes totalmente qualificados de arquivos.fOptions
[in] Sinalizadores de comando (não usados no momento).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 |
Histórico de versão foi obtido com êxito. |
SCC_I_RELOADFILE |
O sistema de controle de origem, na verdade, modificado o arquivo no disco ao buscar o histórico (por exemplo, por meio de uma versão antiga do mesmo), para que o IDE deve recarregar esse arquivo. |
SCC_E_FILENOTCONTROLLED |
O arquivo não está sob controle de origem. |
SCC_E_OPNOTSUPPORTED |
O sistema de controle de origem não oferece suporte para esta operação. |
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_PROJNOTOPEN |
O projeto não foi aberto. |
SCC_E_NONSPECIFICERROR |
Falha de não-específica. Não foi possível obter o histórico do arquivo. |
Comentários
O plug-in de controle de origem pode exibir sua própria caixa de diálogo para mostrar o histórico de cada arquivo, usando hWnd como a janela pai. Como alternativa, o retorno de chamada de saída um texto opcional função fornecido para o Função SccOpenProject pode ser usado, se houver suporte.
Observe que em determinadas circunstâncias, o arquivo sendo examinado podem ser alterados durante a execução desta chamada. Por exemplo, o Visual SourceSafe comando history dá ao usuário a oportunidade de obter uma versão antiga do arquivo. Nesse caso, a fonte de controlar retorna plug-in SCC_I_RELOAD para avisar o IDE para que ele precisa recarregar o arquivo.
Dica
Se o plug-in de controle de origem não oferece suporte a essa função para uma matriz de arquivos, apenas o histórico do arquivo para o primeiro arquivo pode ser exibido.