QUERYCHANGESFUNCQUERYCHANGESFUNC

Se trata de una función de devolución de llamada utilizada el SccQueryChanges operación para enumerar una colección de nombres de archivo y determina el estado de cada archivo.This is a callback function used by the SccQueryChanges operation to enumerate a collection of file names and determine each file's status.

El SccQueryChanges función tiene una lista de archivos y un puntero a la QUERYCHANGESFUNC devolución de llamada.The SccQueryChanges function is given a list of files and a pointer to the QUERYCHANGESFUNC callback. El complemento de control de origen enumera sobre la lista y muestra el estado (a través de esta devolución de llamada) para cada archivo en la lista.The source control plug-in enumerates over the given list and provides status (via this callback) for each file in the list.

SignaturaSignature

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

ParámetrosParameters

pvCallerDatapvCallerData
[in] El pvCallerData parámetro pasado por el llamador (el IDE) a SccQueryChanges.[in] The pvCallerData parameter passed by the caller (the IDE) to SccQueryChanges. El complemento de control de código fuente debe hacer ninguna suposición sobre el contenido de este valor.The source control plug-in should make no assumptions about the contents of this value.

pChangesDatapChangesData
[in] Puntero a un QUERYCHANGESDATA estructura estructura que describe los cambios en un archivo.[in] Pointer to a QUERYCHANGESDATA Structure structure describing the changes to a file.

Valor devueltoReturn Value

El IDE devuelve un código de error correspondiente:The IDE returns an appropriate error code:

ValorValue DescripciónDescription
SCC_OKSCC_OK Continuar el procesamiento.Continue processing.
SCC_I_OPERATIONCANCELEDSCC_I_OPERATIONCANCELED Detiene el procesamiento.Stop processing.
SCC_E_xxxSCC_E_xxx Cualquier error de SCC correspondiente debe detener el procesamiento.Any appropriate SCC error should stop processing.

Estructura QUERYCHANGESDATAQUERYCHANGESDATA Structure

La estructura pasada en cada archivo tiene el siguiente aspecto: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
Tamaño de esta estructura (en bytes).Size of this structure (in bytes).

lpFileNamelpFileName
El nombre de archivo original para este elemento.The original file name for this item.

dwChangeTypedwChangeType
Código que indica el estado del archivo:Code indicating status of the file:

CódigoCode DescripciónDescription
SCC_CHANGE_UNKNOWN No se puede saber qué ha cambiado.Cannot tell what has changed.
SCC_CHANGE_UNCHANGED Ningún cambio de nombre para este archivo.No name changes for this file.
SCC_CHANGE_DIFFERENT Archivo con una identidad diferente, pero no existe el mismo nombre en la base de datos.File with a different identity, but the same name exists in the database.
SCC_CHANGE_NONEXISTENT Archivo no existe en la base de datos o de forma local.File does not exist either in the database or locally.
SCC_CHANGE_DATABASE_DELETED Archivo eliminado en la base de datos.File deleted in the database.
SCC_CHANGE_LOCAL_DELETED Archivo eliminado localmente, pero el archivo sigue existiendo en la base de datos.File deleted locally but the file still exists in the database. Si no puede determinarse, devolver SCC_CHANGE_DATABASE_ADDED.If this cannot be determined, return SCC_CHANGE_DATABASE_ADDED.
SCC_CHANGE_DATABASE_ADDED Archivo agregado a la base de datos, pero no existe localmente.File added to the database but does not exist locally.
SCC_CHANGE_LOCAL_ADDED Archivo no existe en la base de datos y es un nuevo archivo local.File does not exist in database and is a new local file.
SCC_CHANGE_RENAMED_TO Archivo cambiado de nombre o en la base de datos como lpLatestName.File renamed or moved in the database as lpLatestName.
SCC_CHANGE_RENAMED_FROM Archivo cambiado de nombre o en la base de datos de lpLatestName; si esto es demasiado caro realizar un seguimiento, devolver una marca diferente, como 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
El nombre de archivo actual para este elemento.The current file name for this item.

Vea tambiénSee Also

Funciones de devolución de llamada implementadas por el IDE Callback Functions Implemented by the IDE
SccQueryChanges SccQueryChanges
Códigos de errorError Codes