POPLISTFUNC
Dieser Rückruf wird an SccPopulateList-Funktion von der IDE bereitgestellt und wird durch das Quellcodeverwaltungs-Plug-In verwendet, um eine Liste von Dateien oder Verzeichnissen zu aktualisieren ( SccPopulateList die Funktion ebenfalls angegeben).
Wenn ein Benutzer den Befehl Abrufen in der IDE auswählt, zeigt die IDE ein Listenfeld aller Dateien an, die der Benutzer abrufen kann. Leider kennt die IDE nicht die genauen Liste aller Dateien, die der Benutzer abriefe. Nur das Plug-In enthält diese Liste. Wenn andere Benutzer Dateien mit dem Quellcodeverwaltungsprojekt hinzugefügt wurden, sollten diese Dateien in der Liste angezeigt werden, aber die IDE hat keine Kenntnis von ihnen aus. Die IDE erstellt eine Liste der Dateien, dass es denkt, dass der Benutzer abrufen kann. Bevor sie diese Liste an den Benutzer anzeigt, ruft sie SccPopulateList-Funktion, an, das das Quellcodeverwaltungs-Plug-In eine Möglichkeit besteht, Dateien aus der Liste hinzuzufügen oder zu löschen.
Signatur
Das Quellcodeverwaltungs-Plug-In ändert die Liste, indem eine IDE-implementierte Funktion mit folgendem Prototyp aufruft:
typedef BOOL (*POPLISTFUNC) (
LPVOID pvCallerData,
BOOL fAddRemove,
LONG nStatus,
LPSTR lpFileName
);
Parameter
pvCallerData
Der Parameter übergeben pvCallerData vom Aufrufer (die IDE) SccPopulateList-Funktion. Das Quellcodeverwaltungs-Plug-In soll nichts über den Inhalt dieses Parameters annehmen.fAddRemove
Wenn TRUE, lpFileName eine Datei handelt, die zur Dateiliste hinzugefügt werden soll. Wenn FALSE, lpFileName um eine Datei handelt, die aus der Dateiliste gelöscht werden soll.nStatus
Status der lpFileName (eine Kombination der SCC_STATUS Bits. Ausführliche Informationen finden Sie unter Dateistatuscode-Enumerator ).lpFileName
Vollständiger Verzeichnispfad des aus der Liste hinzuzufügen oder zu löschen, Dateinamens.
Rückgabewert
Wert |
Beschreibung |
|---|---|
TRUE |
Das Plug-In kann der Aufruf dieser Funktion fortfahren. |
FALSE |
Es wurde ein Problem in der IDE-Seite gegeben (z. B. eine Situation aufgrund von ungenügendem Arbeitsspeicher). Das Plug-In sollte Vorgang beenden. |
Hinweise
Für jede Datei, in der das Quellcodeverwaltungs-Plug-In möchte Hinzufügen oder Löschen von der Dateiliste, ruft diese Funktion auf und übergibt lpFileName. Das fAddRemove-Flag wird eine neue Datei angezeigt, um Listen- oder Löschen einer alten Datei hinzuzufügen. Der nStatus-Parameter gibt den Status der Datei. Wenn das SCC-Plug-In das Hinzufügen und Löschen von Dateien abgeschlossen ist, wird es vom SccPopulateList-Funktion Aufruf zurück.
Hinweis
Das SCC_CAP_POPULATELIST-Funktion bit ist für Visual Studio erforderlich.