Értesítések (Setup API)

Az értesítések olyan értékek, amelyeket a beállítási függvény egy visszahívási rutinnak küld egy állapot vagy esemény megadásához. A rendszer két paramétert (Param1 és Param2) küld az értesítéssel, és az értesítéshez kapcsolódó további információkat tartalmaz.

A visszahívási rutin feldolgozza az értesítést, és egy aláíratlan egész számot ad vissza a beállítási függvénynek. A beállítási függvénytől függően ezt az értéket használhatja egy művelet vagy felhasználó kiválasztásához, vagy figyelmen kívül hagyhatja azt.

A beállítási függvények az alábbi szintaxissal küldenek értesítéseket a visszahívási rutinoknak.

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

A Környezeti paraméter üres mutató egy környezeti változóhoz vagy szerkezethez, amelyet a visszahívási rutin felhasználhat a visszahívási rutin későbbi hívásai között megőrzendő információk tárolására.

Mivel a visszahívási rutin meghatározza a környezet implementációját, és a beállítási függvények soha nem hivatkoznak rá vagy módosítják azt, a környezet nem lesz dokumentálva a következő értesítési üzenetek referenciaanyagában.

Az Notification paraméter egy olyan esemény vagy állapot aláíratlan egész értékét adja meg, amely miatt a beállítási függvény meghívja a visszahívási rutint.

Param1 és Param2 választható paraméterek, amelyek az értesítéshez kapcsolódó további információkat tartalmazhatnak. Ezek a paraméterek aláíratlan egész számok. Ha Param1 vagy Param2 nem aláíratlan egész számot ad vissza, akkor az előjel nélküli egész számra kerül, és át kell adni az eredeti adattípusára, mielőtt a visszahívási rutin felhasználhatja.

Jegyzet

Az alábbi értesítések a beállítási függvények által használt összes értesítést jelzik. Az egyes függvények ezeknek az értesítéseknek egy részét használják. Más szóval nem minden függvény minden értesítést használ.

 

A beállítási függvények az alábbi értesítéseket használják.

Értesítés	Leírás
SPFILENOTIFY_COPYERROR	Hiba történt egy fájlmásolási művelet során.
SPFILENOTIFY_DELETEERROR	Hiba történt egy fájltörlési művelet során.
SPFILENOTIFY_ENDCOPY	A fájlmásolási művelet befejeződött.
SPFILENOTIFY_ENDDELETE	A fájltörlési művelet befejeződött.
SPFILENOTIFY_ENDQUEUE	Az üzenetsor véglegesítése befejeződött.
SPFILENOTIFY_ENDREGISTRATION	A fájl regisztrációja vagy törlése befejeződött.
SPFILENOTIFY_ENDRENAME	A fájl átnevezési művelete véget ért.
SPFILENOTIFY_ENDSUBQUEUE	Egy alqueue (másolás, átnevezés vagy törlés) véget ért.
SPFILENOTIFY_FILEEXTRACTED	A fájlt kinyerték a kabinetből.
SPFILENOTIFY_FILEINCABINET	A kabinetben fájl található.
SPFILENOTIFY_FILEOPDELAYED	A fájl használatban volt, és az aktuális műveletet a rendszer újraindításáig késleltették.
SPFILENOTIFY_LANGMISMATCH	Az aktuális művelet nyelve nem egyezik a rendszer nyelvével.
SPFILENOTIFY_NEEDMEDIA	Új forrás adathordozóra van szükség.
SPFILENOTIFY_NEEDNEWCABINET	Az aktuális fájl a következő kabinetben folytatódik.
SPFILENOTIFY_QUEUESCAN	A rendszer megvizsgálta a fájlsor egyik csomópontját.
SPFILENOTIFY_QUEUESCAN_EX	A rendszer megvizsgálta a fájlsor egyik csomópontját.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	A rendszer megvizsgálta a fájlsor egyik csomópontját.
SPFILENOTIFY_RENAMEERROR	Hiba történt egy fájl átnevezési művelete során.
SPFILENOTIFY_STARTCOPY	Megkezdődött egy fájlmásolási művelet.
SPFILENOTIFY_STARTDELETE	Megkezdődött egy fájltörlési művelet.
SPFILENOTIFY_STARTQUEUE	Az üzenetsor megkezdte a véglegesítést.
SPFILENOTIFY_STARTREGISTRATION	A fájl regisztrációja vagy törlése megkezdődött.
SPFILENOTIFY_STARTRENAME	Megkezdődött egy fájl átnevezési művelete.
SPFILENOTIFY_STARTSUBQUEUE	Elindult egy alqueue (másolás, átnevezés vagy törlés).
SPFILENOTIFY_TARGETEXISTS	A megadott fájl másolata már létezik a célon.
SPFILENOTIFY_TARGETNEWER	A megadott fájl egy újabb verziója létezik a célon.