Udostępnij za pośrednictwem

Instalowanie pliku wykazu przy użyciu narzędzia CryptCATAdminAddCatalog

  • Artykuł

Program instalacyjny może używać funkcji kryptograficznych CryptCATAdminAddCatalog i innych funkcji kryptograficznych z grupy CryptCATAdminXxx, aby programistycznie zainstalować plik katalogowy w bazie danych składników i sterowników systemu.

Program instalacyjny musi używać zestawu Microsoft Windows Software Development Kit (SDK) dla systemów Windows 7 i .NET Framework 4.0 w następujący sposób:

  • Pliki źródłowe programu instalacyjnego muszą zawierać następujące pliki nagłówka (.h):

    • mscat.h, która definiuje prototypy i struktury dla różnych funkcji CryptCATAdminXxx.
    • Softpub.h, który definiuje różne struktury danych i identyfikatory GUID używane przez funkcje CryptCATAdminXxx.

  • Program instalacyjny musi połączyć się z Wintrust.lib.

Aby użyć tych funkcji kryptograficznych CryptCATAdminXxx, program instalacyjny wykonuje następujące czynności:

  1. Wywołuje CryptCATAdminAcquireContext w celu uzyskania dojścia do kontekstu administratora katalogu. Aplikacja identyfikuje podsystem, ustawiając parametr wejściowy pgSubsystem na wskaźnik do identyfikatora GUID DRIVER_ACTION_VERIFY. Ten identyfikator GUID jest zdefiniowany w Softpub.h.

  2. Wywołuje CryptCATAdminAddCatalog, aby dodać plik wykazu do bazy danych składników systemu i sterowników. Program instalacyjny dostarcza dojście do kontekstu administratora katalogu, który został uzyskany w kroku 1, wskaźnik do w pełni kwalifikowanej ścieżki pliku wykazu i wskaźnik do nazwy pliku wykazu używanego przez funkcję do zainstalowania kopii pliku wykazu w bazie danych. Funkcja zwraca uchwyt do kontekstu informacji katalogu dla pliku wykazu dodanego do bazy danych.

  3. Wywołuje CryptCATAdminReleaseCatalogContext, aby zwolnić dojście do kontekstu informacji katalogu dla pliku wykazu. Program instalacyjny dostarcza dojście do kontekstu administratora katalogu uzyskanego w kroku 1 oraz dojście do kontekstu informacji katalogu zwróconego w kroku 2.

  4. Wywołuje CryptCATAdminReleaseContext, aby zwolnić dojście do kontekstu administratora katalogu. Aplikacja dostarcza dojście do kontekstu administratora wykazu uzyskanego w kroku 1.