GenerateDerivedKey

Genera una chiave derivata in base a una chiave simmetrica utilizzata dal sistema CardSpace.

HRESULT
___stdcall GenerateDerivedKey(
        __in PINFORMATIONCARD_CRYPTO_HANDLE  hCrypto,
    __in DWORD                    cbLabel,
    __in_bcount( cbLabel ) PBYTE  pLabel,
    __in DWORD                    cbNonce,
    __in_bcount( cbNonce ) PBYTE  pNonce,
    __in DWORD                    derivedKeyLength,
    __in DWORD                    offset,
    __in LPCWSTR                  algId,
    __out DWORD*                  pcbKey,
    __out_bcount( *pcbKey ) PBYTE* ppKey );

Parametri

Parametro	Descrizione
hCrypto	Handle per l'oggetto di crittografia associato a un token di protezione rilasciato in precedenza.
cbLabel	Lunghezza, in byte, dell'etichetta.
pLabel	Etichetta.
cbNonce	Lunghezza, in byte, del parametro nonce.
pNonce	Parametro nonce.
derivedKeyLength	Lunghezza desiderata della chiave derivata.
offset	Offset dell'hash generato dall'etichetta e parametro nonce da cui deve essere estratta la chiave generata.
algId	URI del valore di stringa che identifica l'algoritmo di derivazione della chiave da utilizzare. PSHA1 è l'unico algoritmo attualmente supportato.
pcbKey	Lunghezza della chiave derivata.
ppKey	Puntatore a un buffer contenente la chiave derivata. Tale buffer deve essere liberato dopo l'utilizzo utilizzando la funzione GlobalFree.

Valore proprietà/Valore restituito

HRESULT.

Requisiti

Windows Vista

Intestazione: dichiarata in infocard.h.

Libreria: utilizzare infocardapi.lib.

Vedere anche

Concetti

Valori HRESULT restituiti

Invia commenti su questo argomento a Microsoft.

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.