GenerateDerivedKey

Article
04/22/2008

Génère une clé dérivée selon une clé symétrique détenue par le système 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 );

Paramètres

Paramètre	Description
hCrypto	Handle de l'objet de chiffrement associé à un jeton de sécurité précédemment émis.
cbLabel	Longueur, en octets, de l'étiquette.
pLabel	Étiquette.
cbNonce	Longueur, en octets, du nonce.
pNonce	Nonce.
derivedKeyLength	Longueur souhaitée de la clé dérivée.
offset	Décalage du hachage généré par l'étiquette et nonce dont la clé générée doit être extraite.
algId	URI de chaîne qui identifie l'algorithme de dérivation de clés à utiliser. PSHA1 est le seul algorithme actuellement pris en charge.
pcbKey	Longueur de la clé dérivée.
ppKey	Pointeur vers une mémoire tampon qui contient la clé dérivée. Cette mémoire tampon doit être libérée après son utilisation à l'aide de la fonction GlobalFree.

Valeur de propriété/valeur de retour

HRESULT.

Spécifications

Windows Vista

En-tête : déclaré dans infocard.h.

Bibliothèque : utiliser infocardapi.lib.

Voir aussi

Concepts

HRESULTS retournés

Footer image

Envoyer des commentaires sur cette rubrique à Microsoft.

Partager via