Funzione CryptExportKey (wincrypt.h)

Un handle alla chiave da esportare viene passato alla funzione e la funzione restituisce un BLOB di chiavi. Questo BLOB di chiavi può essere inviato su un trasporto non sicuro o archiviato in un percorso di archiviazione non sicuro. Questa funzione può esportare una chiave di sessione Schannel , una chiave di sessione regolare, una chiave pubblica o una coppia di chiavi pubblica/privata. Il BLOB della chiave da esportare non è inutile finché il destinatario non usa la funzione CryptImportKey su di esso per importare la chiave o la coppia di chiavi nel CSP di un destinatario.

Sintassi

BOOL CryptExportKey(
  [in]      HCRYPTKEY hKey,
  [in]      HCRYPTKEY hExpKey,
  [in]      DWORD     dwBlobType,
  [in]      DWORD     dwFlags,
  [out]     BYTE      *pbData,
  [in, out] DWORD     *pdwDataLen
);

Parametri

[in] hKey

Handle alla chiave da esportare.

[in] hExpKey

Handle a una chiave crittografica dell'utente di destinazione. I dati chiave all'interno del BLOB della chiave esportata vengono crittografati usando questa chiave. Ciò garantisce che solo l'utente di destinazione sia in grado di usare il BLOB della chiave. Sia hExpKey che hKey devono venire dallo stesso CSP.

La maggior parte delle volte è la chiave pubblica di scambio delle chiavi dell'utente di destinazione. Tuttavia, alcuni protocolli in alcuni provider di servizi di configurazione richiedono che una chiave di sessione appartenente all'utente di destinazione venga usata per questo scopo.

Se il tipo BLOB di chiave specificato da dwBlobType è PUBLICKEYBLOB, questo parametro è inutilizzato e deve essere impostato su zero.

Se il tipo BLOB di chiave specificato da dwBlobType è PRIVATEKEYBLOB, questo è in genere un handle per una chiave di sessione da usare per crittografare il BLOB della chiave. Alcuni provider di servizi di rete consentono a questo parametro di essere zero, nel qual caso l'applicazione deve crittografare manualmente il BLOB della chiave privata in modo da proteggerlo.

Per determinare il modo in cui i provider di servizi di crittografia Microsoft rispondono a questo parametro, vedere le sezioni BLOB delle chiavi private dei provider di servizi di crittografia Microsoft.

[in] dwBlobType

Specifica il tipo di BLOB della chiave da esportare in pbData. Questa deve essere una delle costanti seguenti, come illustrato in Archiviazione chiavi crittografiche e Exchange.

[in] dwFlags

Specifica opzioni aggiuntive per la funzione. Questo parametro può essere zero o una combinazione di uno o più dei valori seguenti.

[out] pbData

Puntatore a un buffer che riceve i dati BLOB delle chiavi . Il formato di questo BLOB varia a seconda del tipo BLOB richiesto nel parametro dwBlobType . Per il formato per PRIVATEKEYBLOBs, PUBLICKEYBLOBs e SIMPLEBLOBs, vedere BLOBS chiave provider di base.

Se questo parametro è NULL, la dimensione del buffer necessaria viene inserita nel valore a cui punta il parametro pdwDataLen . Per altre informazioni, vedere Recupero dei dati di lunghezza sconosciuta.

[in, out] pdwDataLen

Puntatore a un valore DWORD che, nella voce, contiene le dimensioni, in byte, del buffer a cui punta il parametro pbData . Quando la funzione restituisce, questo valore contiene il numero di byte archiviati nel buffer.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce non zero (TRUE).

Se la funzione ha esito negativo, restituisce zero (FALSE). Per informazioni sull'errore estese, chiamare GetLastError.

I codici di errore preceduti da "NTE" vengono generati dal particolare CSP usato. La tabella seguente mostra alcuni dei possibili codici di errore.

Commenti

Per una delle permutazioni delle chiavi DES che usano un file PLAINTEXTKEYBLOB, è possibile esportare solo le dimensioni complete della chiave, incluso il bit di parità. Sono supportate le dimensioni delle chiavi seguenti.

Esempio

Nell'esempio seguente viene illustrato come esportare una chiave crittografica o una coppia di chiavi in modo più sicuro. In questo esempio si presuppone che sia stato acquisito un contesto crittografico e che una chiave pubblica sia disponibile per l'esportazione. Per un esempio che include il contesto completo per l'uso di questa funzione, vedere Esempio di programma C: firma di un hash e verifica della firma hash. Per un altro esempio che usa questa funzione, vedere Esempio di programma C: Esportazione di una chiave di sessione.

#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>

BOOL GetExportedKey(
    HCRYPTKEY hKey, 
    DWORD dwBlobType,
    LPBYTE *ppbKeyBlob, 
    LPDWORD pdwBlobLen)
{
    DWORD dwBlobLength;
    *ppbKeyBlob = NULL;
    *pdwBlobLen = 0;

    // Export the public key. Here the public key is exported to a 
    // PUBLICKEYBLOB. This BLOB can be written to a file and
    // sent to another user.

    if(CryptExportKey(   
        hKey,    
        NULL,    
        dwBlobType,
        0,    
        NULL, 
        &dwBlobLength)) 
    {
        printf("Size of the BLOB for the public key determined. \n");
    }
    else
    {
        printf("Error computing BLOB length.\n");
        return FALSE;
    }

    // Allocate memory for the pbKeyBlob.
    if(*ppbKeyBlob = (LPBYTE)malloc(dwBlobLength)) 
    {
        printf("Memory has been allocated for the BLOB. \n");
    }
    else
    {
        printf("Out of memory. \n");
        return FALSE;
    }

    // Do the actual exporting into the key BLOB.
    if(CryptExportKey(   
        hKey, 
        NULL,    
        dwBlobType,    
        0,    
        *ppbKeyBlob,    
        &dwBlobLength))
    {
        printf("Contents have been written to the BLOB. \n");
        *pdwBlobLen = dwBlobLength;
    }
    else
    {
        printf("Error exporting key.\n");
        free(*ppbKeyBlob);
        *ppbKeyBlob = NULL;

        return FALSE;
    }

    return TRUE;
}

Requisiti

Vedi anche

CryptImportKey

Generazione di chiavi e funzioni di Exchange