Condividi tramite


Funzione SccQueryInfo

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

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

Parametri

  • pvContext
    [in] La struttura del contesto di plug-in controllo del codice sorgente.

  • nFiles
    [in] Numero di file specificato nella matrice di lpFileNames e nella lunghezza della matrice di lpStatus .

  • lpFileNames
    [in] Una matrice di nomi di file in cui eseguire la query.

  • lpStatus
    [in, out] Una matrice in cui il plug-in controllo del codice sorgente restituisce i contrassegni di stato per ogni file. Per ulteriori informazioni, vedere Enumeratore del codice dello stato del file.

Valore restituito

L'implementazione di plug-in controllo del codice sorgente di questa funzione è previsto che restituisca uno dei seguenti valori:

Valore

Descrizione

SCC_OK

La query è stata completata.

SCC_E_ACCESSFAILURE

Si è verificato un problema con accedere al sistema di controllo del codice sorgente, probabilmente causato da problemi di conflitto o della rete. Un tentativo è consigliato.

SCC_E_PROJNOTOPEN

Il progetto non è controllo del codice sorgente di seguito aperto.

SCC_E_NONSPECIFICERROR

errore non specifico.

Note

Se lpFileName è una stringa vuota, non sono attualmente informazioni sullo stato da aggiornare. In caso contrario, è il nome di percorso completo del file per il quale le informazioni possono modificare.

La matrice restituita può essere una maschera di bit di bit di SCC_STATUS_xxxx . Per ulteriori informazioni, vedere Enumeratore del codice dello stato del file. Un sistema di controllo del codice sorgente non può supportare tutti i tipi di bit. Ad esempio, se SCC_STATUS_OUTOFDATE non viene fornito, il bit non è impostata solo.

Quando si utilizza questa funzione per estrarre file, tenere presenti i seguenti requisiti dello stato di MSSCCI :

  • SCC_STATUS_OUTBYUSER viene impostato quando l'utente corrente è verificato il file.

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

  • SCC_STATUS_CHECKEDOUT è impostata solo quando il file viene controllato-fuori nella directory di lavoro definita.

  • Se il file è controllato-fuori dall'utente corrente in una directory diversa dalla directory di lavoro, SCC_STATUS_OUTBYUSER è impostato ma SCC_STATUS_CHECKEDOUT non è.

Vedere anche

Riferimenti

Enumeratore del codice dello stato del file

Concetti

Funzioni API del plug-in del controllo del codice sorgente