Metodo ICEnroll::get_GenKeyFlags (xenroll.h)

Articolo
08/28/2023

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà GenKeyFlags imposta o recupera i valori passati alla funzione CryptGenKey quando viene generata la richiesta di certificato.

Per impostazione predefinita, la proprietà GenKeyFlags è impostata su zero. Tuttavia, quando viene specificato un file con estensione pvk, il valore predefinito di GenKeyFlags è CRYPT_EXPORTABLE. Per altre informazioni, vedere la sezione Osservazioni.

Questa proprietà è stata definita per la prima volta nell'interfaccia ICEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_GenKeyFlags(
  LONG *pdwFlags
);

Parametri

pdwFlags

Valore restituito

nessuno

Osservazioni

Per impostazione predefinita, le chiavi private non sono esportabili a meno che non venga richiesto un file con estensione pvk. Per rendere esportabile la chiave privata senza specificare un file con estensione pvk, impostare GenKeyFlags su CRYPT_EXPORTABLE.

Per specificare un nome di file con estensione pvk, utilizzare la proprietà PVKFileName .

Il valore della proprietà GenKeyFlags viene passato alla funzione CryptGenKey CryptoAPI usando il relativo parametro dwFlags .

Se il provider di servizi di crittografia (CSP) non supporta chiavi private esportabili, si verifica un errore.

La proprietà GenKeyFlags influisce sul comportamento dei metodi seguenti:

Nota Il valore predefinito per la proprietà GenKeyFlags è zero. Se è necessario modificare questo valore, è necessario eseguire questa operazione prima di chiamare questi metodi. Dopo aver chiamato uno di questi metodi, non è possibile modificare il valore della proprietà GenKeyFlags .

Esempio

LONG     lGenKey;
HRESULT  hr;

// pEnroll is a previously instantiated ICEnroll interface pointer.

// Get the GenKeyFlags value.
hr = pEnroll->get_GenKeyFlags( &lGenKey );
if (FAILED( hr ))
    printf("Failed get_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags: %d\n", lGenKey );

// Set the GenKeyFlags value.
hr = pEnroll->put_GenKeyFlags( CRYPT_EXPORTABLE );
if (FAILED( hr ))
    printf("Failed put_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags set to %d\n", CRYPT_EXPORTABLE );

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	xenroll.h
Libreria	Uuid.lib
DLL	Xenroll.dll