Freigeben über

QUERYCHANGESFUNC

  • Artikel

Dies ist eine Rückruffunktion, die vom SccQueryChanges-Vorgang verwendet wird, um eine Auflistung von Dateinamen auflisten und den Status der einzelnen Dateien zu bestimmen.

Die SccQueryChanges Funktion erhält eine Liste von Dateien und einen Zeiger auf den QUERYCHANGESFUNC Rückruf. Das Quellcodeverwaltungs-Plug-In listet die angegebene Liste auf und stellt den Status (über diesen Rückruf) für jede Datei in der Liste bereit.

Signature

typedef BOOL (*QUERYCHANGESFUNC)(
   LPVOID pvCallerData,
   QUERYCHANGESDATA * pChangesData
);

Parameter

pvCallerData

[in] Der pvCallerData Parameter, der vom Aufrufer (der IDE) an SccQueryChanges übergeben wird. Das Quellcodeverwaltungs-Plug-In sollte keine Annahmen über den Inhalt dieses Werts machen.

pChangesData

[in] Zeigen Sie auf eine QUERYCHANGESDATA-Strukturstruktur , die die Änderungen an einer Datei beschreibt.

Rückgabewert

Die IDE gibt einen geeigneten Fehlercode zurück:

Wert Beschreibung
SCC_OK Setzen Sie die Verarbeitung fort.
SCC_I_OPERATIONCANCELED Beendet die Verarbeitung.
SCC_E_xxx Jeder entsprechende SCC-Fehler sollte die Verarbeitung beenden.

QUERYCHANGESDATA-Struktur

Die für jede Datei übergebene Struktur sieht wie folgt aus:

struct QUERYCHANGESDATA_A
{
    DWORD  dwSize;
    LPCSTR lpFileName;
    DWORD  dwChangeType;
    LPCSTR lpLatestName;
};

typedef struct QUERYCHANGESDATA_A QUERYCHANGESDATA;

struct QUERYCHANGESDATA_W
{
    DWORD   dwSize;
    LPCWSTR lpFileName;
    DWORD   dwChangeType;
    LPCWSTR lpLatestName;
};

dwSize Size of this structure (in Bytes).

lpFileName Der ursprüngliche Dateiname für dieses Element.

dwChangeType Code, der den Status der Datei angibt:

Code Beschreibung
SCC_CHANGE_UNKNOWN Es kann nicht mitgeteilt werden, was sich geändert hat.
SCC_CHANGE_UNCHANGED Für diese Datei werden keine Namensänderungen vorgenommen.
SCC_CHANGE_DIFFERENT Datei mit einer anderen Identität, aber derselbe Name ist in der Datenbank vorhanden.
SCC_CHANGE_NONEXISTENT Die Datei ist weder in der Datenbank noch lokal vorhanden.
SCC_CHANGE_DATABASE_DELETED Datei in der Datenbank gelöscht.
SCC_CHANGE_LOCAL_DELETED Die Datei wurde lokal gelöscht, aber die Datei ist weiterhin in der Datenbank vorhanden. Wenn dies nicht bestimmt werden kann, wird die Rückgabe SCC_CHANGE_DATABASE_ADDEDzurückgegeben.
SCC_CHANGE_DATABASE_ADDED Datei, die der Datenbank hinzugefügt, aber nicht lokal vorhanden ist.
SCC_CHANGE_LOCAL_ADDED Die Datei ist in der Datenbank nicht vorhanden und ist eine neue lokale Datei.
SCC_CHANGE_RENAMED_TO Datei umbenannt oder in die Datenbank verschoben als lpLatestName.
SCC_CHANGE_RENAMED_FROM Datei umbenannt oder in der Datenbank verschoben von lpLatestName; wenn dies zu teuer ist, um nachzuverfolgen, geben Sie ein anderes Flag zurück, z SCC_CHANGE_DATABASE_ADDED. B. . .

lpLatestName Der aktuelle Dateiname für dieses Element.

Siehe auch