Condividi tramite

Funzione SccDirQueryInfo

  • Articolo

Questa funzione esamina un elenco di directory complete per il relativo stato corrente.

Sintassi

SCCRTN SccDirQueryInfo(
LPVOID  pContext,
LONG    nDirs,
LPCSTR* lpDirNames,
LPLONG  lpStatus
);

Parametri

pContext

[in] Struttura del contesto del plug-in del controllo del codice sorgente.

nDirs

[in] Numero di directory selezionate per la query.

lpDirNames

[in] Matrice di percorsi completi delle directory su cui eseguire query.

lpStatus

[in, out] Struttura di matrice per il plug-in del controllo del codice sorgente per restituire i flag di stato (vedere Codice di stato della directory per informazioni dettagliate).

Valore restituito

L'implementazione del plug-in del controllo del codice sorgente di questa funzione dovrebbe restituire uno dei valori seguenti:

Valore Descrizione
SCC_OK La query ha avuto esito positivo.
SCC_E_OPNOTSUPPORTED Il sistema di controllo del codice sorgente non supporta questa operazione.
SCC_E_ACCESSFAILURE Si è verificato un problema durante l'accesso al sistema di controllo del codice sorgente, probabilmente a causa di problemi di rete o contesa. È consigliabile riprovare.
SCC_E_NONSPECIFICERROR

SCC_E_UNKNOWNERROR		 Errore non specifico.

Osservazioni:

La funzione riempie la matrice restituita con una maschera di bit di bit dalla SCC_DIRSTATUS famiglia (vedere Codice di stato della directory), una voce per ogni directory specificata. La matrice di stato viene allocata dal chiamante.

L'IDE usa questa funzione prima che una directory venga rinominata per verificare se la directory è sotto il controllo del codice sorgente eseguendo una query su se dispone di un progetto corrispondente. Se la directory non è sotto il controllo del codice sorgente, l'IDE può fornire l'avviso appropriato all'utente.

Nota

Se un plug-in del controllo del codice sorgente sceglie di non implementare uno o più valori di stato, i bit non implementati devono essere impostati su zero.

Vedi anche