SccDirQueryInfo – funkce
Tato funkce prozkoumá seznam plně kvalifikovaných adresářů pro jejich aktuální stav.
Syntaxe
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Parametry
pContext
[v] Kontextová struktura modulu plug-in správy zdrojového kódu.
NDirs
[v] Počet adresářů vybraných k dotazování.
lpDirNames
[v] Pole plně kvalifikovaných cest adresářů, které se mají dotazovat.
lpStatus
[in, out] Struktura pole modulu plug-in správy zdrojového kódu pro vrácení stavových příznaků (podrobnosti najdete v stavovém kódu adresáře).
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_OPNOTSUPPORTED | Systém správy zdrojového kódu tuto operaci nepodporuje. |
| SCC_E_ACCESSFAILURE | Při přístupu k systému správy zdrojového kódu došlo k potížím, pravděpodobně kvůli problémům se sítí nebo kolizí. Doporučuje se opakování. |
| SCC_E_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Nespecifické selhání. |
Poznámky
Funkce vyplní vrácené pole bitovou maskou bitů z SCC_DIRSTATUS rodiny (viz stavový kód adresáře), jednou položkou pro každý zadaný adresář. Pole stavu je přiděleno volajícím.
Integrované vývojové prostředí (IDE) používá tuto funkci před přejmenováním adresáře ke kontrole, jestli je adresář pod správou zdrojového kódu, dotazováním, jestli má odpovídající projekt. Pokud adresář není pod správou zdrojového kódu, může integrované vývojové prostředí (IDE) uživateli poskytnout správné upozornění.
Poznámka:
Pokud se modul plug-in správy zdrojového kódu rozhodne neimplementovat jednu nebo více stavových hodnot, měly by být neplementované bity nastaveny na nulu.