Condividi tramite


Funzione GetCryptProvFromCert

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