Funzione SccQueryInfo

  • Articolo

Questa funzione ottiene informazioni sullo stato per un set di file selezionati nel controllo del codice sorgente.

Sintassi

SCCRTN SccQueryInfo(
   LPVOID  pvContext,
   LONG    nFiles,
   LPCSTR* lpFileNames,
   LPLONG  lpStatus
);

Parametri

pvContext

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

nFiles

[in] Numero di file specificati nella lpFileNames matrice e nella lunghezza della lpStatus matrice.

lpFileNames

[in] Matrice di nomi di file su cui eseguire una query.

lpStatus

[in, out] Matrice in cui il plug-in del controllo del codice sorgente restituisce i flag di stato per ogni file. Per altre informazioni, vedere Codice di stato del file.

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_ACCESSFAILURE Si è verificato un problema con l'accesso al sistema di controllo del codice sorgente, probabilmente causato da problemi di rete o contesa. È consigliabile riprovare.
SCC_E_PROJNOTOPEN Il progetto non è aperto sotto il controllo del codice sorgente.
SCC_E_NONSPECIFICERROR Errore non specifico.

Osservazioni:

Se lpFileName è una stringa vuota, non sono attualmente presenti informazioni sullo stato da aggiornare. In caso contrario, è il nome completo del percorso del file per cui le informazioni sullo stato potrebbero essere state modificate.

La matrice restituita può essere una maschera di bit di SCC_STATUS_xxxx bit. Per altre informazioni, vedere Codice di stato del file. Un sistema di controllo del codice sorgente potrebbe non supportare tutti i tipi di bit. Ad esempio, se SCC_STATUS_OUTOFDATE non viene offerto, il bit non è impostato.

Quando si usa questa funzione per archiviare i file, tenere presente i requisiti di stato seguenti MSSCCI :

  • SCC_STATUS_OUTBYUSER viene impostato quando l'utente corrente ha estratto il file.

  • SCC_STATUS_CHECKEDOUT non può essere impostato a meno che SCC_STATUS_OUTBYUSER non sia impostato.

  • SCC_STATUS_CHECKEDOUT viene impostato solo quando il file viene estratto nella directory di lavoro designata.

  • Se il file viene estratto dall'utente corrente in una directory diversa dalla directory di lavoro, SCC_STATUS_OUTBYUSER viene impostato ma SCC_STATUS_CHECKEDOUT non.

Vedi anche