GenerateDerivedKey

Generiert auf Grundlage eines symmetrischen Schlüssels des CardSpace-Systems einen abgeleiteten Schlüssel.

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

Parameter

Parameter	Beschreibung
hCrypto	Handle für das Kryptografieobjekt, das einem zuvor freigegebenen Sicherheitstoken zugeordnet ist.
cbLabel	Die Länge der Bezeichnung in Bytes.
pLabel	Die Bezeichnung.
cbNonce	Die Nonce-Länge in Bytes.
pNonce	Die Nonce.
derivedKeyLength	Die gewünschte Länge des abgeleiteten Schlüssels.
offset	Der Offset des Hashwertes, der anhand der Bezeichnung und der Nonce generiert wurde. Er dient dem Extrahieren des generierten Schlüssels.
algId	Ein Zeichenfolgen-URI, der den zu verwendenden Schlüsselableitungsalgorithmus identifiziert. Derzeit ist PSHA1 der einzige unterstützte Algorithmus.
pcbKey	Die Länge des abgeleiteten Schlüssels.
ppKey	Zeiger auf einen Puffer, der den abgeleiteten Schlüssel enthält. Dieser Puffer muss nach der Verwendung mit der GlobalFree-Funktion freigegeben werden.

Eigenschaftenwert/Rückgabewert

HRESULT

Voraussetzungen

Windows Vista

Header: in infocard.h deklariert.

Library: Verwenden Sie infocardapi.lib.

Siehe auch

Konzepte

Zurückgegebene HRESULTS

Footer image

Senden Sie Kommentare zu diesem Thema an Microsoft.

Last updated on 2007-12-17

Freigeben über