GenerateDerivedKey

Generates a derived key based on a symmetric key held by the CardSpace system.

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 );

Parameters

Parameter	Description
hCrypto	Handle to the cryptographic object associated with a previously released security token.
cbLabel	The length, in bytes, of the label.
pLabel	The label.
cbNonce	The length, in bytes, of the nonce.
pNonce	The nonce.
derivedKeyLength	The desired length of the derived key.
offset	The offset of the hash generated from the label and nonce from which the generated key should be extracted.
algId	A string URI that identifies the key derivation algorithm to use. PSHA1 is the only currently supported algorithm.
pcbKey	The length of the derived key.
ppKey	Pointer to a buffer containing the derived key. This buffer must be freed after use by using the GlobalFree function.

Property Value/Return Value

HRESULT.

Requirements

Windows Vista

Header: Declared in infocard.h.

Library: Use infocardapi.lib.

See Also

Concepts

HRESULTS Returned

Copyright © 2007 by Microsoft Corporation. All rights reserved.