SccQueryInfo – funkce

  • Článek

Tato funkce získá informace o stavu pro sadu vybraných souborů ve správě zdrojového kódu.

Syntaxe

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

Parametry

pvContext

[v] Kontextová struktura modulu plug-in správy zdrojového kódu.

nSoubory

[v] Počet souborů zadaných v lpFileNames matici a délka lpStatus pole

lpFileNames

[v] Pole názvů souborů, které se mají dotazovat.

lpStatus

[in, out] Pole, ve kterém modul plug-in správy zdrojového kódu vrátí stavové příznaky pro každý soubor. Další informace naleznete v tématu Stavový kód souboru.

Vrácená hodnota

Očekává se, že implementace modulu plug-in správy zdrojového kódu této funkce vrátí jednu z následujících hodnot:

Hodnota Popis
SCC_OK Dotaz byl úspěšný.
SCC_E_ACCESSFAILURE Při přístupu k systému správy zdrojového kódu došlo k potížím, pravděpodobně způsobené problémy se sítí nebo kolizí. Doporučuje se opakování.
SCC_E_PROJNOTOPEN Projekt není v rámci správy zdrojového kódu otevřený.
SCC_E_NONSPECIFICERROR Nespecifické selhání.

Poznámky

Pokud lpFileName je prázdný řetězec, aktuálně se neaktualizují žádné informace o stavu. Jinak se jedná o úplný název cesty k souboru, pro který se mohly změnit informace o stavu.

Návratové pole může být bitová maska SCC_STATUS_xxxx bitů. Další informace naleznete v tématu Stavový kód souboru. Systém správy zdrojového kódu nemusí podporovat všechny typy bitů. Pokud SCC_STATUS_OUTOFDATE například není nabízena, bit se nenastaví.

Při použití této funkce k rezervaci souborů si poznamenejte následující MSSCCI požadavky na stav:

  • SCC_STATUS_OUTBYUSER je nastavena, když aktuální uživatel rezervoval soubor.

  • SCC_STATUS_CHECKEDOUT nelze nastavit, pokud SCC_STATUS_OUTBYUSER není nastavena.

  • SCC_STATUS_CHECKEDOUT je nastavena pouze v případech, kdy je soubor rezervován do určeného pracovního adresáře.

  • Pokud je soubor rezervován aktuálním uživatelem do jiného adresáře, než je pracovní adresář, je nastaven, SCC_STATUS_OUTBYUSER ale SCC_STATUS_CHECKEDOUT není.

Viz také