Função SccDirQueryInfo
Esta função examina uma lista de diretórios totalmente qualificados para o seu status atual.
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Parâmetros
pContext
[in] A estrutura de contexto de plug-in de controle de origem.nDirs
[in] O número de diretórios selecionada a ser consultado.lpDirNames
[in] Uma matriz de caminhos totalmente qualificados dos diretórios a serem consultados.lpStatus
[in, out] Uma estrutura de array para o plug-in para retornar os sinalizadores de status de controle de origem (consulte Enumerador de código de Status do diretório para obter detalhes).
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 consulta foi bem-sucedida. |
SCC_E_OPNOTSUPPORTED |
O sistema de controle de código fonte 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_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Falha de não-específica. |
Comentários
A função preenche a matriz de retorno com uma máscara de bits a partir do SCC_DIRSTATUS família (consulte Enumerador de código de Status do diretório), uma entrada para cada diretório fornecido. A matriz de status é alocada pelo chamador.
O IDE usa essa função antes de um diretório é renomeado para verificar se o diretório está sob controle de origem por meio de consulta se ele tem um projeto correspondente. Se o diretório não está sob controle de origem, o IDE pode fornecer o aviso apropriado para o usuário.
Dica
Se escolher um plug-in de controle de origem implementa um ou mais dos valores de status, o bits não implementados devem ser definidos como zero.
Consulte também
Referência
Enumerador de código de Status do diretório