QUERYCHANGESFUNCQUERYCHANGESFUNC

Il s’agit d’une fonction de rappel utilisée par le SccQueryChanges opération pour énumérer une collection de noms de fichiers et de déterminer l’état de chaque fichier.This is a callback function used by the SccQueryChanges operation to enumerate a collection of file names and determine each file's status.

Le SccQueryChanges fonction reçoit une liste de fichiers et un pointeur vers le QUERYCHANGESFUNC rappel.The SccQueryChanges function is given a list of files and a pointer to the QUERYCHANGESFUNC callback. Le plug-in de contrôle de source énumère la liste donnée et fournit l’état (via ce rappel) pour chaque fichier dans la liste.The source control plug-in enumerates over the given list and provides status (via this callback) for each file in the list.

SignatureSignature

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

ParamètresParameters

pvCallerDatapvCallerData
[in] Le pvCallerData paramètre passé par l’appelant (l’IDE) pour SccQueryChanges.[in] The pvCallerData parameter passed by the caller (the IDE) to SccQueryChanges. Le plug-in de contrôle de code source doit-elle pas faire d’hypothèses sur le contenu de cette valeur.The source control plug-in should make no assumptions about the contents of this value.

pChangesDatapChangesData
[in] Pointeur vers un QUERYCHANGESDATA Structure structure qui décrit les modifications apportées à un fichier.[in] Pointer to a QUERYCHANGESDATA Structure structure describing the changes to a file.

Valeur de retourReturn Value

L’IDE retourne un code d’erreur approprié :The IDE returns an appropriate error code:

ValueValue DescriptionDescription
SCC_OKSCC_OK Continuer le traitement.Continue processing.
SCC_I_OPERATIONCANCELEDSCC_I_OPERATIONCANCELED Arrêter le traitement.Stop processing.
SCC_E_xxxSCC_E_xxx Une erreur de contrôle de code source appropriée doit arrêter le traitement.Any appropriate SCC error should stop processing.

Structure QUERYCHANGESDATAQUERYCHANGESDATA Structure

La structure passée dans chaque fichier ressemble à ceci :The structure passed in for each file looks like the following:

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;  
};  

dwSizedwSize
Taille de cette structure (en octets).Size of this structure (in bytes).

lpFileNamelpFileName
Le nom de fichier d’origine pour cet élément.The original file name for this item.

dwChangeTypedwChangeType
Code indiquant l’état du fichier :Code indicating status of the file:

CodeCode DescriptionDescription
SCC_CHANGE_UNKNOWN Impossible d’indiquer ce qui a changé.Cannot tell what has changed.
SCC_CHANGE_UNCHANGED Aucune modification de nom pour ce fichier.No name changes for this file.
SCC_CHANGE_DIFFERENT Fichier avec une identité différente, mais le même nom existe dans la base de données.File with a different identity, but the same name exists in the database.
SCC_CHANGE_NONEXISTENT Fichier n’existe pas dans la base de données ou localement.File does not exist either in the database or locally.
SCC_CHANGE_DATABASE_DELETED Fichier a été supprimé dans la base de données.File deleted in the database.
SCC_CHANGE_LOCAL_DELETED Fichier supprimé localement, mais le fichier existe toujours dans la base de données.File deleted locally but the file still exists in the database. Si cela ne peut pas être déterminé, retourner SCC_CHANGE_DATABASE_ADDED.If this cannot be determined, return SCC_CHANGE_DATABASE_ADDED.
SCC_CHANGE_DATABASE_ADDED Fichier ajouté à la base de données, mais n’existe pas localement.File added to the database but does not exist locally.
SCC_CHANGE_LOCAL_ADDED Fichier n’existe pas dans la base de données et un nouveau fichier local.File does not exist in database and is a new local file.
SCC_CHANGE_RENAMED_TO Fichiers renommés ou déplacés dans la base de données en tant que lpLatestName.File renamed or moved in the database as lpLatestName.
SCC_CHANGE_RENAMED_FROM Fichiers renommés ou déplacés dans la base de données à partir de lpLatestName; si cela est trop coûteuse pour effectuer le suivi, retourne un indicateur différent, tel que SCC_CHANGE_DATABASE_ADDED.File renamed or moved in the database from lpLatestName; if this is too expensive to track, return a different flag, such as SCC_CHANGE_DATABASE_ADDED.

lpLatestNamelpLatestName
Le nom de fichier actuel pour cet élément.The current file name for this item.

Voir aussiSee Also

Fonctions de rappel implémentées par l’IDE Callback Functions Implemented by the IDE
SccQueryChanges SccQueryChanges
Codes d’erreurError Codes