Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Rejestrowanie SetupAPI obsługuje mechanizm, który ustanawia kontekst dziennika dla wątku. Ten kontekst jest ustanawiany przez ustawienie tokenu logu dla wątku. SetupAPI udostępnia ten mechanizm, dzięki czemu kod wywoływany przez wątek może zapisywać wpisy dziennika w kontekście dziennika wątku wywołującego.
Na przykład wątek może ustawić token dziennika dla kontekstu dziennika, zanim wywoła instalatora klasy lub współinstalatora. Instalator może z kolei pobrać token dziennika wątku wywołującego i użyć tego tokenu do zapisywania wpisów dziennika w sekcji dziennika tekstowego skojarzonej z kontekstem dziennika wywołującego wątku.
Ustawianie tokenu dziennika dla wątku
Funkcja SetupSetThreadLogToken ustawia token dziennika dla wątku, z którego została wywołana ta funkcja. Token dziennika może być tokenem dziennika zdefiniowanym przez system lub tokenem dziennika, który został pobrany przez wywołanie metody SetupGetThreadLogToken.
Poniżej przedstawiono przykłady sposobu ustanowienia kontekstu dziennika dla wątku:
Aplikacja instalacji może wywołać metodę SetupSetThreadLogToken , aby ustanowić kontekst dziennika dla innego kodu instalacyjnego, który jest uruchamiany w tym samym wątku. Podczas ustanawiania kontekstu dziennika dla wątku aplikacja powinna używać tokenu dziennika zdefiniowanego przez system, takiego jak LOGTOKEN_SETUPAPI_APPLOG, w wywołaniu metody SetupSetThreadLogToken.
Uwaga Jeśli kontekst dziennika jest ustawiany przy użyciu zdefiniowanego przez system tokenu logu, kolejne wywołania funkcji logowania SetupAPI wykonane z tego kontekstu dziennika, zapisują wpisy dziennika w dzienniku tekstowym instalacji, które nie są częścią sekcji dziennika tekstowego.
Jeśli instalator klasy lub współinstalator uruchamia nowy wątek, instalator może ustawić kontekst dziennika dla tego wątku na taki sam jak dla wątku nadrzędnego. Odbywa się to w następujący sposób:
- Zanim wątek nadrzędny uruchomi nowy wątek, uzyskuje bieżący token dziennika przez wywołanie SetupGetThreadLogToken.
- Wątek nadrzędny uruchamia nowy wątek i przekazuje bieżący token dziennika za pomocą metody specyficznej dla implementacji, takiej jak zapisywanie tokenu w zmiennej globalnej.
- Nowy wątek wywołuje element SetupSetThreadLogToken z bieżącym tokenem dziennika. W rezultacie nowy wątek "dziedziczy" kontekst dziennika wątku nadrzędnego.
Uwaga Jeśli wątek instalatora klasy lub współinstalatora ustawia kontekst dziennika przy użyciu tej metody, kolejne wywołania funkcji rejestrowania SetupAPI, wykonywane z tego kontekstu dziennika, zapisują wpisy dziennika w tekstowym dzienniku instalacji, które mogą stanowić część sekcji dziennika tekstowego. Dzieje się tak tylko wtedy, gdy sekcja dziennika tekstowego została ustanowiona przez operację instalacji SetupAPI, która wywołała instalator.
Poniżej przedstawiono przykład wywołania metody SetupSetThreadLogToken, która ustawia kontekst dziennika bieżącego wątku na dziennik tekstowy instalacji urządzenia (SetupAPI.app.log) przez określenie zdefiniowanego przez system tokenu dziennika LOGTOKEN_SETUPAPI_APPLOG. Kolejne wywołanie funkcji rejestrowania SetupAPI , która używa tego kontekstu dziennika, spowoduje zapisanie wpisu dziennika w dzienniku tekstowym instalacji urządzenia, ale nie w ramach sekcji dziennika tekstowego.
SP_LOG_TOKEN LogToken = LOGTOKEN_SETUPAPI_APPLOG;
SetupSetThreadLogToken(LogToken);
Pobieranie tokenu logu dla wątku
Funkcja SetupGetThreadLogToken pobiera token dziennika dla wątku, z którego została wywołana ta funkcja.
Na przykład instalator klas może wywołać funkcję SetupGetThreadLogToken, aby pobrać token dziennika, który ma zastosowanie do operacji SetupAPI, która wywołała instalator klas. Instalator klas może następnie użyć tego pobranego tokenu dziennika do rejestrowania wpisów w dzienniku tekstowym odnoszącym się do odpowiedniej operacji SetupAPI.
Uwaga Jeśli kontekst dziennika wątku nie został wcześniej ustawiony przez wywołanie metody SetupSetThreadLogToken, wywołanie metody SetupGetThreadLogToken zwraca token dziennika z wartością LOGTOKEN_UNSPECIFIED.
Poniżej przedstawiono przykład wywołania metody SetupGetThreadLogToken , która pobiera token dziennika dla bieżącego wątku.
SP_LOG_TOKEN LogToken = SetupGetThreadLogToken();