estructura CF_CALLBACK_INFO (cfapi.h)
Contiene información de devolución de llamada común, como el tipo de devolución de llamada, el proceso de usuario que desencadena la devolución de llamada y la información básica sobre el archivo en el que se solicita la devolución de llamada.
Sintaxis
typedef struct CF_CALLBACK_INFO {
DWORD StructSize;
CF_CONNECTION_KEY ConnectionKey;
LPVOID CallbackContext;
PCWSTR VolumeGuidName;
PCWSTR VolumeDosName;
DWORD VolumeSerialNumber;
LARGE_INTEGER SyncRootFileId;
LPCVOID SyncRootIdentity;
DWORD SyncRootIdentityLength;
LARGE_INTEGER FileId;
LARGE_INTEGER FileSize;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
PCWSTR NormalizedPath;
CF_TRANSFER_KEY TransferKey;
UCHAR PriorityHint;
PCORRELATION_VECTOR CorrelationVector;
CF_PROCESS_INFO *ProcessInfo;
CF_REQUEST_KEY RequestKey;
} CF_CALLBACK_INFO;
Miembros
StructSize
Tamaño de CF_CALLBACK_INFO.
ConnectionKey
Identificador opaco creado por CfConnectSyncRoot para una raíz de sincronización administrada por el proveedor de sincronización. ConnectionKey se devuelve como una comodidad, por lo que el proveedor de sincronización no necesita realizar un seguimiento manual de él.
CallbackContext
Apunta a un blob opaco que el proveedor de sincronización proporciona en el tiempo de conexión raíz de sincronización. CallbackContext se devuelve como una comodidad, por lo que el proveedor de sincronización no necesita realizar un seguimiento manual de él.
VolumeGuidName
Nombre GUID del volumen en el que reside el archivo o directorio del marcador de posición que se va a atender. Está en forma: "\?\Volume{GUID}".
VolumeDosName
Letra de unidad DOS del volumen en forma de "X:" donde X es la letra de unidad.
VolumeSerialNumber
Número de serie del volumen.
SyncRootFileId
Un sistema de archivos de 64 bits mantenido, identificador único de todo el volumen de la raíz de sincronización en la que reside el archivo de marcador de posición o el directorio que se va a atender.
SyncRootIdentity
Apunta al blob opaco proporcionado por el proveedor de sincronización en la hora de registro raíz de sincronización.
SyncRootIdentityLength
Longitud, en bytes, de SyncRootIdentity.
FileId
Un sistema de archivos de 64 bits mantenido, identificador único de todo el volumen del archivo de marcador de posición o directorio que se va a atender.
FileSize
Tamaño lógico del archivo de marcador de posición que se va a atender. Siempre es 0 si el asunto de la devolución de llamada es un directorio.
FileIdentity
Apunta al blob opaco que proporciona el proveedor de sincronización en el tiempo de creación, conversión y actualización del marcador de posición.
FileIdentityLength
Longitud, en bytes, de FileIdentity.
NormalizedPath
Ruta de acceso absoluta del archivo de marcador de posición o directorio que se va a atender en el volumen identificado por VolumeGuidName/VolumeDosName. Se inicia desde el directorio raíz del volumen. Consulte la sección Comentarios para obtener más detalles.
TransferKey
Identificador opaco del archivo o directorio del marcador de posición que se va a atender. El proveedor de sincronización debe devolverlo a la llamada CfExecute para realizar la operación deseada en el archivo o directorio.
PriorityHint
Escala numérica dada al proveedor de sincronización para describir la prioridad relativa de una captura en comparación con otra, con el fin de proporcionar la experiencia más dinámica al usuario. Los valores van de 0 (prioridad más baja posible) a 15 (prioridad más alta posible), pero de lo contrario, los valores no tienen ningún significado específico. El filtro puede ajustar cómo elige sugerencias de prioridad según las condiciones. El proveedor de sincronización es libre de usar la sugerencia, pero elige.
CorrelationVector
Vector de correlación opcional.
ProcessInfo
Apunta a una estructura de CF_PROCESS_INFO que contiene la información sobre el proceso de usuario que desencadena esta devolución de llamada. Solo está presente si el proveedor de sincronización especifica CF_CONNECT_FLAG_REQUIRE_PROCESS_INFO en el momento de la conexión raíz de sincronización.
RequestKey
Identificador opaco que identifica de forma única una operación de archivo en la nube en un archivo en la nube determinado, tal como se indica en TransferKey. Los proveedores de sincronización no necesitan interpretar este campo. El único requisito en un proveedor de sincronización es transferirlo tal como está en CF_OPERATION_INFO.
Observaciones
Un nombre de archivo se considera normalizado si se cumplen todas las siguientes condiciones:
- Contiene la ruta de acceso completa del directorio para el archivo, incluido el nombre del volumen, a menos que el usuario abra el archivo por identificador de archivo, pero no tiene privilegios de recorrido para toda la ruta de acceso. (Para obtener más información, vea FltGetFileNameInformation).
- El nombre del volumen es el nombre del objeto de dispositivo no persistente del volumen (por ejemplo, "\Device\HarddiskVolume1").
- Todos los nombres cortos se expanden a los nombres largos equivalentes.
- Las cadenas ":$DATA" o "::$DATA" finales se quitan del nombre de la secuencia.
- Se resuelven todos los puntos de montaje.
Requisitos
| Cliente mínimo compatible | Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Encabezado | cfapi.h |