Bildirimler (Kurulum API'si)

Bildirimler, bir kurulum işlevinin durum veya olay belirtmek için geri çağırma yordamına gönderdiği değerlerdir. Param1 ve Param2 iki parametre bildirimle birlikte gönderilir ve bildirimle ilgili ek bilgiler içerir.

Geri çağırma yordamı, bildirimi işler ve kurulum işlevine işaretsiz bir tamsayı döndürür. Kurulum işlevine bağlı olarak, bir işlem veya kullanıcı seçimi belirtmek için bu değeri kullanabilir veya yoksayabilirsiniz.

Kurulum işlevleri, aşağıdaki söz dizimini kullanarak geri çağırma yordamlarına bildirim gönderir.

MsgHandler(          //the specified callback routine
    Context,         //context used by the callback routine
    Notification,    //notification code
    Param1,          //additional notification information
    Param2           //additional notification information
);

Context parametresi, geri çağırma yordamının geri çağırma yordamına yapılan sonraki çağrılar arasında kalıcı olması gereken bilgileri depolamak için kullanabileceği bir bağlam değişkenine veya yapıya ilişkin geçersiz bir işaretçidir.

Geri çağırma yordamı bağlamın uygulamasını belirttiğinden ve kurulum işlevleri tarafından hiçbir zaman başvurulmadığı veya değiştirilmediği için bağlam, izleyen bildirim iletilerinin başvuru malzemesinde belgelenmez.

Notification parametresi, kurulum işlevinin geri çağırma yordamını çağırmasına neden olan bir olay veya durum için işaretsiz bir tamsayı değeri belirtir.

Param1 ve Param2, bildirimle ilgili ek bilgiler içerebilen isteğe bağlı parametrelerdir. Bu parametreler işaretsiz tamsayılardır. Param1 veya param2 işaretsiz tamsayı olmayan bilgileri döndürürse, imzasız bir tamsayıya dönüştürülür ve geri çağırma yordamı tarafından kullanılmadan önce özgün veri türüne yeniden yayınlanmalıdır.

Not

Aşağıdaki bildirimler, kurulum işlevleri tarafından kullanılan her bildirimi temsil eder. Tek tek işlevler bu bildirimlerin bir alt kümesini kullanır. Başka bir deyişle, her bildirim her işlev tarafından kullanılmaz.

 

Aşağıdaki bildirimler kurulum işlevleri tarafından kullanılır.

Bildirim	Açıklama
SPFILENOTIFY_COPYERROR	Dosya kopyalama işlemi sırasında bir hata oluştu.
SPFILENOTIFY_DELETEERROR	Dosya silme işlemi sırasında bir hata oluştu.
SPFILENOTIFY_ENDCOPY	Dosya kopyalama işlemi sona erdi.
SPFILENOTIFY_ENDDELETE	Dosya silme işlemi sona erdi.
SPFILENOTIFY_ENDQUEUE	Kuyruk işlemeyi tamamladı.
SPFILENOTIFY_ENDREGISTRATION	Dosyanın kaydı veya kaydını kaldırma işlemi tamamlandı.
SPFILENOTIFY_ENDRENAME	Dosya yeniden adlandırma işlemi sona erdi.
SPFILENOTIFY_ENDSUBQUEUE	Alt sorgu (kopyalama, yeniden adlandırma veya silme) sona erdi.
SPFILENOTIFY_FILEEXTRACTED	Dosya, dolaptan ayıklandı.
SPFILENOTIFY_FILEINCABINET	Kabinde bir dosyayla karşılaşılır.
SPFILENOTIFY_FILEOPDELAYED	Dosya kullanımdaydı ve geçerli işlem sistem yeniden başlatılana kadar geciktirildi.
SPFILENOTIFY_LANGMISMATCH	Geçerli işlemin dili sistem diliyle eşleşmiyor.
SPFILENOTIFY_NEEDMEDIA	Yeni kaynak medya gereklidir.
SPFILENOTIFY_NEEDNEWCABINET	Geçerli dosya bir sonraki kabinde devam edilir.
SPFILENOTIFY_QUEUESCAN	Dosya kuyruğundaki bir düğüm tarandı.
SPFILENOTIFY_QUEUESCAN_EX	Dosya kuyruğundaki bir düğüm tarandı.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	Dosya kuyruğundaki bir düğüm tarandı.
SPFILENOTIFY_RENAMEERROR	Dosya yeniden adlandırma işlemi sırasında bir hata oluştu.
SPFILENOTIFY_STARTCOPY	Dosya kopyalama işlemi başlatıldı.
SPFILENOTIFY_STARTDELETE	Bir dosya silme işlemi başlatıldı.
SPFILENOTIFY_STARTQUEUE	Kuyruk işlemeye başladı.
SPFILENOTIFY_STARTREGISTRATION	Dosyanın kaydı veya kaydı silindi.
SPFILENOTIFY_STARTRENAME	Dosya yeniden adlandırma işlemi başlatıldı.
SPFILENOTIFY_STARTSUBQUEUE	Bir alt sorgu (kopyalama, yeniden adlandırma veya silme) başlatıldı.
SPFILENOTIFY_TARGETEXISTS	Belirtilen dosyanın bir kopyası hedefte zaten var.
SPFILENOTIFY_TARGETNEWER	Hedefte belirtilen dosyanın daha yeni bir sürümü var.