struktur CF_CALLBACK_INFO (cfapi.h)

Berisi informasi panggilan balik umum seperti jenis panggilan balik, proses pengguna yang memicu panggilan balik, dan informasi dasar tentang file tempat panggilan balik diminta.

Sintaks

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;

Anggota

StructSize

Ukuran CF_CALLBACK_INFO.

ConnectionKey

Handel buram yang dibuat oleh CfConnectSyncRoot untuk akar sinkronisasi yang dikelola oleh penyedia sinkronisasi. ConnectionKey dikembalikan sebagai kenyamanan sehingga penyedia sinkronisasi tidak perlu melacaknya secara manual.

CallbackContext

Menunjuk ke blob buram yang disediakan penyedia sinkronisasi pada waktu koneksi root sinkronisasi. CallbackContext dikembalikan sebagai kenyamanan sehingga penyedia sinkronisasi tidak perlu melacaknya secara manual.

VolumeGuidName

Nama GUID volume tempat file/direktori tempat penampung berada. Ini dalam bentuk: "\?\Volume{GUID}".

VolumeDosName

Huruf kandar DOS volume dalam bentuk "X:" di mana X adalah huruf kandar.

VolumeSerialNumber

Nomor seri volume.

SyncRootFileId

Sistem file 64 bit dipertahankan, ID unik seluruh volume dari akar sinkronisasi tempat file atau direktori tempat penampung berada.

SyncRootIdentity

Menunjuk ke blob buram yang disediakan oleh penyedia sinkronisasi pada waktu pendaftaran akar sinkronisasi.

SyncRootIdentityLength

Panjang, dalam byte, dari SyncRootIdentity.

FileId

Sistem file 64 bit dipertahankan, ID unik seluruh volume dari file tempat penampung atau direktori yang akan dilayankan.

FileSize

Ukuran logis file tempat penampung yang akan dilayankan. 0 Selalu jika subjek panggilan balik adalah direktori.

FileIdentity

Menunjuk ke blob buram yang disediakan penyedia sinkronisasi pada waktu pembuatan/konversi/pembaruan tempat penampung.

FileIdentityLength

Panjang, dalam byte, dari FileIdentity.

NormalizedPath

Jalur absolut file atau direktori tempat penampung yang akan dilayankan pada volume yang diidentifikasi oleh VolumeGuidName/VolumeDosName. Dimulai dari direktori akar volume. Lihat bagian Keterangan untuk detail selengkapnya.

TransferKey

Handel buram ke file/direktori tempat penampung yang akan dilayankan. Penyedia sinkronisasi harus meneruskannya kembali ke panggilan CfExecute untuk melakukan operasi yang diinginkan pada file/direktori.

PriorityHint

Skala numerik yang diberikan kepada penyedia sinkronisasi untuk menjelaskan prioritas relatif satu pengambilan dibandingkan dengan pengambilan lain, untuk memberikan pengalaman yang paling responsif kepada pengguna. Nilai berkisar dari 0 (prioritas semurah mungkin) hingga 15 (prioritas setingkat mungkin), tetapi jika tidak, nilai tidak memiliki arti khusus. Filter dapat menyesuaikan bagaimana filter memilih petunjuk prioritas sesuai dengan kondisi. Penyedia sinkronisasi bebas untuk menggunakan petunjuk namun ia memilih.

CorrelationVector

Vektor korelasi opsional.

ProcessInfo

Menunjuk ke struktur CF_PROCESS_INFO yang berisi informasi tentang proses pengguna yang memicu panggilan balik ini. Ini hanya ada jika penyedia sinkronisasi menentukan CF_CONNECT_FLAG_REQUIRE_PROCESS_INFO pada waktu sambung akar sinkronisasi.

RequestKey

Id buram yang secara unik mengidentifikasi operasi file cloud pada file cloud tertentu seperti yang ditunjukkan oleh TransferKey. Penyedia sinkronisasi tidak perlu menginterpretasikan bidang ini. Satu-satunya persyaratan pada penyedia sinkronisasi adalah mentransfernya apa adanya untuk CF_OPERATION_INFO.

Keterangan

Nama file dianggap dinormalisasi jika semua hal berikut ini benar:

• Ini berisi jalur direktori lengkap untuk file, termasuk nama volume, kecuali pengguna membuka file dengan ID file tetapi tidak memiliki hak istimewa melintasi untuk seluruh jalur. (Untuk informasi selengkapnya, lihat FltGetFileNameInformation.)
• Nama volume adalah nama objek perangkat volume yang tidak persisten (misalnya, "\Device\HarddiskVolume1").
• Semua nama pendek diperluas ke nama panjang yang setara.
• String ":$DATA" atau "::$DATA" berikutnya dihapus dari nama aliran.
• Semua titik pemasangan diselesaikan.

Persyaratan

Lihat juga

CfConnectSyncRoot

CfExecute

CF_PROCESS_INFO

CF_OPERATION_INFO

FltGetFileNameInformation