Freigeben über

SccQueryInfo-Funktion

  • Artikel

Diese Funktion ruft Statusinformationen für eine Gruppe ausgewählter Dateien unter Quellcodeverwaltung ab.

Syntax

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

Parameter

pvContext

[in] Die Kontextstruktur des Quellcodeverwaltungs-Plug-Ins.

nFiles

[in] Die Anzahl der im lpFileNames Array angegebenen Dateien und die Länge des lpStatus Arrays.

lpFileNames

[in] Ein Array von Namen von Dateien, die abgefragt werden sollen.

lpStatus

[in, out] Ein Array, in dem das Quellcodeverwaltungs-Plug-In die Statuskennzeichnungen für jede Datei zurückgibt. Weitere Informationen finden Sie unter Dateistatuscode.

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_ACCESSFAILURE Beim Zugriff auf das Quellcodeverwaltungssystem ist ein Problem aufgetreten, das wahrscheinlich durch Netzwerk- oder Inhaltsprobleme verursacht wurde. Es wird ein Wiederholungsversuche empfohlen.
SCC_E_PROJNOTOPEN Das Projekt ist nicht unter Quellcodeverwaltung geöffnet.
SCC_E_NONSPECIFICERROR Nicht spezifischer Fehler.

Hinweise

Wenn lpFileName es sich um eine leere Zeichenfolge handelt, gibt es derzeit keine Statusinformationen, die aktualisiert werden sollen. Andernfalls handelt es sich um den vollständigen Pfadnamen der Datei, für die sich die Statusinformationen möglicherweise geändert haben.

Das Rückgabearray kann eine Bitmaske von SCC_STATUS_xxxx Bits sein. Weitere Informationen finden Sie unter Dateistatuscode. Ein Quellcodeverwaltungssystem unterstützt möglicherweise nicht alle Bittypen. Wenn beispielsweise SCC_STATUS_OUTOFDATE nicht angeboten wird, ist das Bit nicht festgelegt.

Wenn Sie diese Funktion zum Auschecken von Dateien verwenden, beachten Sie die folgenden MSSCCI Statusanforderungen:

  • SCC_STATUS_OUTBYUSER wird festgelegt, wenn der aktuelle Benutzer die Datei ausgecheckt hat.

  • SCC_STATUS_CHECKEDOUT kann nicht festgelegt werden, es sei denn SCC_STATUS_OUTBYUSER , sie ist festgelegt.

  • SCC_STATUS_CHECKEDOUT wird nur festgelegt, wenn die Datei im angegebenen Arbeitsverzeichnis ausgecheckt ist.

  • Wenn die Datei vom aktuellen Benutzer in einem anderen Verzeichnis als dem Arbeitsverzeichnis ausgecheckt wird, SCC_STATUS_OUTBYUSER ist jedoch nicht festgelegt SCC_STATUS_CHECKEDOUT .

Siehe auch