SccDirQueryInfo-Funktion
Diese Funktion untersucht eine Liste der vollqualifizierten Verzeichnisse auf ihren aktuellen Status.
Syntax
SCCRTN SccDirQueryInfo(
LPVOID pContext,
LONG nDirs,
LPCSTR* lpDirNames,
LPLONG lpStatus
);
Parameter
pContext
[in] Die Kontextstruktur des Quellcodeverwaltungs-Plug-Ins.
nDirs
[in] Die Anzahl der verzeichnisse, die abgefragt werden sollen.
lpDirNames
[in] Ein Array vollqualifizierter Pfade der verzeichnisse, die abgefragt werden sollen.
lpStatus
[in, out] Eine Arraystruktur für das Quellcodeverwaltungs-Plug-In, um die Statuskennzeichnungen zurückzugeben (details hierzu finden Sie im Verzeichnisstatuscode ).
Rückgabewert
Die Plug-In-Implementierung dieser Funktion für die Quellcodeverwaltung wird voraussichtlich einen der folgenden Werte zurückgeben:
| Wert | Beschreibung |
|---|---|
| SCC_OK | Die Abfrage war erfolgreich. |
| SCC_E_OPNOTSUPPORTED | Das Quellcodeverwaltungssystem unterstützt diesen Vorgang nicht. |
| SCC_E_ACCESSFAILURE | Es gab ein Problem beim Zugriff auf das Quellcodeverwaltungssystem, wahrscheinlich aufgrund von Netzwerk- oder Inhaltsproblemen. Es wird ein Wiederholungsversuche empfohlen. |
| SCC_E_NONSPECIFICERROR SCC_E_UNKNOWNERROR |
Nicht spezifischer Fehler. |
Hinweise
Die Funktion füllt das Rückgabearray mit einer Bitmaske von Bits aus der SCC_DIRSTATUS Familie (siehe Verzeichnisstatuscode), einem Eintrag für jedes angegebene Verzeichnis. Das Statusarray wird vom Aufrufer zugewiesen.
Die IDE verwendet diese Funktion, bevor ein Verzeichnis umbenannt wird, um zu überprüfen, ob das Verzeichnis unter Quellcodeverwaltung steht, indem sie abfragen, ob es über ein entsprechendes Projekt verfügt. Wenn sich das Verzeichnis nicht unter der Quellcodeverwaltung befindet, kann die IDE dem Benutzer die richtige Warnung bereitstellen.
Hinweis
Wenn ein Quellcodeverwaltungs-Plug-In eine oder mehrere Statuswerte nicht implementiert, sollten nicht implementierte Bits auf Null festgelegt werden.