Installazione di un file di catalogo usando CryptCATAdminAddCatalog

  • Articolo

Un programma di installazione può usare CryptCATAdminAddCatalog e altre funzioni di crittografia CryptCATAdminXxx a livello di codice per installare un file di catalogo nel componente di sistema e nel database driver.

Il programma di installazione deve usare Microsoft Windows Software Development Kit (SDK) per Windows 7 e .NET Framework 4.0 nel modo seguente:

  • I file di origine del programma di installazione devono includere i file di intestazione (.h) seguenti:

    • Mscat.h, che definisce i prototipi e le strutture per le varie funzioni CryptCATAdminXxx .
    • Softpub.h, che definisce le varie strutture di dati e GUID usate dalle funzioni CryptCATAdminXxx .

  • Il programma di installazione deve collegarsi a Wintrust.lib.

Per usare queste funzioni di crittografia CryptCATAdminXxx , un programma di installazione esegue le operazioni seguenti:

  1. Chiama CryptCATAdminAcquireContext per ottenere un handle in un contesto di amministratore del catalogo. L'applicazione identifica il sottosistema impostando il parametro di input pgSubsystem su un puntatore al GUID DRIVER_ACTION_VERIFY. Questo GUID è definito in Softpub.h.

  2. Chiama CryptCATAdminAddCatalog per aggiungere il file di catalogo al database del componente di sistema e del driver. Il programma di installazione fornisce l'handle al contesto dell'amministratore del catalogo ottenuto nel passaggio 1, un puntatore al percorso completo del file di catalogo e un puntatore al nome del file di catalogo usato dalla funzione per installare una copia del file di catalogo nel database. La funzione restituisce un handle al contesto informativo del catalogo per il file di catalogo aggiunto al database.

  3. Chiama CryptCATAdminReleaseCatalogContext per rilasciare l'handle al contesto delle informazioni del catalogo per il file di catalogo. Il programma di installazione fornisce l'handle al contesto dell'amministratore del catalogo ottenuto nel passaggio 1 e l'handle al contesto delle informazioni del catalogo restituito nel passaggio 2.

  4. Chiama CryptCATAdminReleaseContext per rilasciare l'handle al contesto di amministratore del catalogo. L'applicazione fornisce l'handle al contesto di amministratore del catalogo ottenuto nel passaggio 1.