Meddelanden (installations-API)

Meddelanden är värden som en installationsfunktion skickar till en återanropsrutin för att ange ett tillstånd eller en händelse. Två parametrar, Param1 och Param2, skickas med meddelandet och innehåller ytterligare information som är relevant för meddelandet.

Återanropsrutinen bearbetar meddelandet och returnerar ett osignerat heltal till installationsfunktionen. Beroende på installationsfunktionen kan du använda det här värdet för att ange en åtgärd eller användarval, eller så kan du ignorera den.

Installationsfunktionerna skickar meddelanden till återanropsrutiner med hjälp av följande syntax.

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

Parametern Context är en tomhetspekare till en kontextvariabel eller struktur som återanropsrutinen kan använda för att lagra information som måste finnas kvar mellan efterföljande anrop till återanropsrutinen.

Eftersom återanropsrutinen anger kontextens implementering och den aldrig refereras till eller ändras av konfigurationsfunktionerna, dokumenteras inte kontexten i referensmaterialet för de meddelanden som följer.

Parametern Notification anger ett osignerat heltalsvärde för en händelse eller ett tillstånd som gör att installationsfunktionen anropar återanropsrutinen.

Param1 och Param2 är valfria parametrar som kan innehålla ytterligare information som är relevant för meddelandet. Dessa parametrar är osignerade heltal. Om Param1 eller Param2 returnera information som inte är ett osignerat heltal, skickas det till ett osignerat heltal och måste omarbetas till sin ursprungliga datatyp innan det kan användas av återanropsrutinen.

Not

Följande meddelanden representerar varje meddelande som används av installationsfunktionerna. Enskilda funktioner använder en delmängd av dessa meddelanden. Med andra ord används inte varje meddelande av varje funktion.

 

Följande meddelanden används av installationsfunktionerna.

Anmälan	Beskrivning
SPFILENOTIFY_COPYERROR	Ett fel uppstod under en filkopieringsåtgärd.
SPFILENOTIFY_DELETEERROR	Ett fel uppstod under en filborttagningsåtgärd.
SPFILENOTIFY_ENDCOPY	En filkopieringsåtgärd har avslutats.
SPFILENOTIFY_ENDDELETE	En filborttagningsåtgärd har avslutats.
SPFILENOTIFY_ENDQUEUE	Kön har slutfört incheckningen.
SPFILENOTIFY_ENDREGISTRATION	Registreringen eller avregistreringen av filen har slutförts.
SPFILENOTIFY_ENDRENAME	En filbytesåtgärd har avslutats.
SPFILENOTIFY_ENDSUBQUEUE	En underfråga (antingen kopiera, byta namn på eller ta bort) har avslutats.
SPFILENOTIFY_FILEEXTRACTED	Filen har extraherats från skåpet.
SPFILENOTIFY_FILEINCABINET	En fil påträffas i kabinettet.
SPFILENOTIFY_FILEOPDELAYED	Filen användes och den aktuella åtgärden har försenats tills systemet startas om.
SPFILENOTIFY_LANGMISMATCH	Språket för den aktuella åtgärden matchar inte systemspråket.
SPFILENOTIFY_NEEDMEDIA	Nytt källmedium krävs.
SPFILENOTIFY_NEEDNEWCABINET	Den aktuella filen fortsätter i nästa kabinett.
SPFILENOTIFY_QUEUESCAN	En nod i filkön har genomsökts.
SPFILENOTIFY_QUEUESCAN_EX	En nod i filkön har genomsökts.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	En nod i filkön har genomsökts.
SPFILENOTIFY_RENAMEERROR	Ett fel uppstod under en filbytesåtgärd.
SPFILENOTIFY_STARTCOPY	En filkopieringsåtgärd har startats.
SPFILENOTIFY_STARTDELETE	En filborttagningsåtgärd har startats.
SPFILENOTIFY_STARTQUEUE	Kön har börjat checkas in.
SPFILENOTIFY_STARTREGISTRATION	Registreringen eller avregistreringen av filen har startats.
SPFILENOTIFY_STARTRENAME	En filbytesåtgärd har startats.
SPFILENOTIFY_STARTSUBQUEUE	En underfråga (antingen kopiera, byta namn på eller ta bort) har startats.
SPFILENOTIFY_TARGETEXISTS	Det finns redan en kopia av den angivna filen på målet.
SPFILENOTIFY_TARGETNEWER	Det finns en nyare version av den angivna filen på målet.