Funzione GetCryptProvFromCert

Articolo
06/13/2023

Importante

Questa API è deprecata. Microsoft potrebbe rimuovere questa API nelle versioni future.

La funzione GetCryptProvFromCert ottiene un handle per un provider di servizi di crittografia (CSP) e una specifica di chiave per un contesto di certificato . Usare questa funzione per ottenere l'accesso alla chiave privata dell'autorità emittente del certificato.

Nota

Questa funzione non ha un file di intestazione o una libreria di importazione associata. Per chiamare questa funzione, è necessario creare un file di intestazione definito dall'utente e usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Mssign32.dll.

Sintassi

BOOL WINAPI GetCryptProvFromCert(
  _In_      HWND           hwnd,
  _In_      PCCERT_CONTEXT pCert,
  _Out_     HCRYPTPROV     *phCryptProv,
  _Out_     DWORD          *pdwKeySpec,
  _In_      BOOL           *pfDidCryptAcquire,
  _Out_opt_ LPWSTR         *ppwszTmpContainer,
  _Out_opt_ LPWSTR         *ppwszProviderName,
  _Out_     DWORD          *pdwProviderType
);

Parametri

hwnd [in]: Handle della finestra da utilizzare come proprietario di tutte le finestre di dialogo visualizzate. Questo membro non è attualmente utilizzato e viene ignorato. È possibile passare NULL per questo parametro in modo sicuro.
pCert [in]: Puntatore a una struttura di CERT_CONTEXT per il certificato.
phCryptProv [out]: Puntatore a una struttura HCRYPTPROV che rappresenta un handle per il provider di servizi di configurazione.
pdwKeySpec [out]: Specifica della chiave privata da recuperare. I valori possibili includono AT_KEYEXCHANGE o AT_SIGNATURE.
pfDidCryptAcquire [in]: Valore che specifica se la funzione ha acquisito l'handle del provider in base al certificato.
ppwszTmpContainer [out, optional]: Indirizzo di un puntatore a una stringa con terminazione Null per il nome del contenitore di chiavi temporaneo. La funzione GetCryptProvFromCert fornisce e inizializza il contenitore temporaneo. Quando si chiama GetCryptProvFromCert, l'indirizzo deve puntare a un valore NULL .
ppwszProviderName [out, optional]: Indirizzo di un puntatore a una stringa con terminazione Null per il nome del provider. La funzione GetCryptProvFromCert restituisce il nome del provider. Quando si chiama GetCryptProvFromCert, l'indirizzo deve puntare a un valore NULL .
pdwProviderType [out]: Specifica il tipo CSP. Può essere zero o uno dei tipi di provider di crittografia. Se questo membro è zero, il contenitore di chiavi è uno dei provider di archiviazione delle chiavi CNG.

Valore restituito

Al termine dell'operazione, questa funzione restituisce TRUE. Se ha esito negativo, la funzione GetCryptProvFromCert restituisce FALSE .

Commenti

Lo strumento MakeCert chiama GetCryptProvFromCert quando lo si richiama usando l'opzione della riga di comando -is .

Se il parametro pfDidCryptAcquire è impostato su TRUE, la funzione imposta i parametri phCryptProv, pdwKeySpec e pdwProviderType sui valori del provider.

Al termine dell'uso del provider di servizi di configurazione, liberarlo chiamando la funzione FreeCryptProvFromCert .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
DLL	Mssign32.dll