Oznámení (rozhraní API pro nastavení)

Oznámení jsou hodnoty, které funkce nastavení odesílá do rutiny zpětného volání za účelem určení stavu nebo události. Dva parametry, Param1 a Param2, se odešlou s oznámením a obsahují další informace týkající se oznámení.

Rutina zpětného volání zpracuje oznámení a vrátí celé číslo bez znaménka funkci nastavení. V závislosti na funkci nastavení můžete tuto hodnotu použít k určení operace nebo výběru uživatele nebo ji můžete ignorovat.

Funkce nastavení odesílají oznámení rutinám zpětného volání pomocí následující syntaxe.

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

Parametr Context je ukazatel na kontextovou proměnnou nebo strukturu, kterou může rutina zpětného volání použít k ukládání informací, které musí být zachovány mezi následnými voláními rutiny zpětného volání.

Vzhledem k tomu, že rutina zpětného volání určuje implementaci kontextu a nikdy se neodkazuje ani nemění funkcemi nastavení, kontext není dokumentován v referenčním materiálu pro zprávy oznámení, které následují.

Parametr Notification určuje celočíselnou hodnotu bez znaménka pro událost nebo stav, který způsobí, že instalační funkce zavolá rutinu zpětného volání.

parametry Param1 a param2 jsou volitelné parametry, které mohou obsahovat další informace týkající se oznámení. Tyto parametry jsou celá čísla bez znaménka. Pokud Param1 nebo Param2 vrátit informace, které nejsou celé číslo bez znaménka, přetypuje se na celé číslo bez znaménka a musí být před použitím rutiny zpětného volání přetypováno na původní datový typ.

Poznámka

Následující oznámení představují všechna oznámení používaná funkcemi nastavení. Jednotlivé funkce používají podmnožinu těchto oznámení. Jinými slovy, ne každé oznámení používá každá funkce.

 

Následující oznámení používají instalační funkce.

Oznámení	Popis
SPFILENOTIFY_COPYERROR	Během operace kopírování souboru došlo k chybě.
SPFILENOTIFY_DELETEERROR	Během operace odstranění souboru došlo k chybě.
SPFILENOTIFY_ENDCOPY	Operace kopírování souboru skončila.
SPFILENOTIFY_ENDDELETE	Operace odstranění souboru skončila.
SPFILENOTIFY_ENDQUEUE	Fronta dokončila potvrzení.
SPFILENOTIFY_ENDREGISTRATION	Registrace nebo zrušení registrace souboru byla dokončena.
SPFILENOTIFY_ENDRENAME	Operace přejmenování souboru skončila.
SPFILENOTIFY_ENDSUBQUEUE	Dílčí fronta (kopírování, přejmenování nebo odstranění) skončila.
SPFILENOTIFY_FILEEXTRACTED	Soubor byl extrahován z skříně.
SPFILENOTIFY_FILEINCABINET	V souboru CAB je zjištěn soubor.
SPFILENOTIFY_FILEOPDELAYED	Soubor byl používán a aktuální operace byla zpožděna, dokud se systém nerestartuje.
SPFILENOTIFY_LANGMISMATCH	Jazyk aktuální operace neodpovídá systémovému jazyku.
SPFILENOTIFY_NEEDMEDIA	Vyžaduje se nové zdrojové médium.
SPFILENOTIFY_NEEDNEWCABINET	Aktuální soubor pokračuje v další skříni.
SPFILENOTIFY_QUEUESCAN	Naskenoval se uzel ve frontě souborů.
SPFILENOTIFY_QUEUESCAN_EX	Naskenoval se uzel ve frontě souborů.
SPFILENOTIFY_QUEUESCAN_SIGNERINFO	Naskenoval se uzel ve frontě souborů.
SPFILENOTIFY_RENAMEERROR	Během operace přejmenování souboru došlo k chybě.
SPFILENOTIFY_STARTCOPY	Spustila se operace kopírování souborů.
SPFILENOTIFY_STARTDELETE	Spustila se operace odstranění souboru.
SPFILENOTIFY_STARTQUEUE	Fronta se začala potvrzovat.
SPFILENOTIFY_STARTREGISTRATION	Registrace nebo zrušení registrace souboru se spustila.
SPFILENOTIFY_STARTRENAME	Byla spuštěna operace přejmenování souboru.
SPFILENOTIFY_STARTSUBQUEUE	Spustila se dílčí fronta (kopírování, přejmenování nebo odstranění).
SPFILENOTIFY_TARGETEXISTS	Kopie zadaného souboru již v cíli existuje.
SPFILENOTIFY_TARGETNEWER	V cíli existuje novější verze zadaného souboru.