Kuyruk Taahhüdü Sırası

SetupCommitFileQueue işlevi dosya kuyruğuna işlendiğinde, dosya işlemlerini şu sırayla işler: dosya silme işlemleri, ardından dosya yeniden adlandırma işlemleri ve son olarak dosya kopyalama işlemleri. Aşağıdaki ana hat, kuyruğun taahhüt sürecinin yaşam döngüsünü gösterir.

 

• delete alt sırasını başlatma
  • <bir dosya silme işlemi başlatın; her bir işlem için yineleyin
  • dosya silme işlemini bitirme <-- kuyruğa alınan dosya silme
• silme alt sorguyu bitirme

• yeniden adlandırma alt sırasını başlatma
  • <bir dosya yeniden adlandırma işlemi başlatın; her bir dosya için yineleyin
  • dosya silme işlemini bitirme <-- kuyruğa alınan dosya yeniden adlandırma
• yeniden adlandırma alt sorguyu bitirme

• kopyalama alt sorguyu başlatma
  • <bir dosya kopyalama işlemi başlatma -- her bir işlem için yineleme
  • <bir dosya kopyalama işlemini bitirme -- kuyruğa alınmış dosya kopyalama
  • kopyalama alt sırasını tamamlama
• kuyruğu bitirme

 

Her adımda veya bir hata oluşursa, SetupCommitFileQueueişlevi geri çağırma yordamına bir bildirim gönderir. Geri çağırma yordamı, yükleme ilerleme durumunu izlemek ve gerekirse kullanıcıyla etkileşime geçmek için kuyruk tarafından gönderilen bilgileri kullanabilir.

Örneğin, bir dosya kopyalama işlemi geçerli yolda kullanılamayan bir kaynak dosyaya ihtiyaç duyuyorsa, SetupCommitFileQueue, gerekli dosya ve medya hakkındaki bilgilerle birlikte geri çağırma yordamına bir SPFILENOTIFY_NEEDMEDIA bildirimi gönderir. Geri çağırma yordamı bu bilgileri kullanarak setuppromptForDiskçağırarak kullanıcıdan sonraki diski eklemesini isteyen bir iletişim kutusu oluşturabilir

Kurulum API'sine setupDefaultQueueCallbackvarsayılan kuyruk geri çağırma yordamı eklenir. Bu yordam kuyruk bildirimlerini işler ve yükleme için hata iletişim kutuları ve ilerleme çubukları oluşturur. Varsayılan kuyruk geri çağırma yordamını olduğu gibi kullanabilir veya bildirimlerin bir alt kümesini işlemek ve diğerlerini varsayılan kuyruk geri çağırma yordamına geçirmek için bir filtre geri çağırma yordamı yazabilirsiniz.

Geri çağırma yordamının işlevlerinden hiçbiri gereksinimlerinize uymuyorsa, varsayılan kuyruk geri çağırma yordamını çağırmayan, bağımsız bir özel geri çağırma yordamı yazabilirsiniz.

Kuyruk geri çağırma yordamları hakkında daha fazla bilgi için bkz. Default Queue Callback Routineve Creating a Custom Queue Callback Routine.