GenerateDerivedKey

Artículo
10/07/2008

Genera una clave derivada basada en una clave simétrica que se encuentra en el 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 );

Parámetros

Parámetro	Descripción
hCrypto	Identificador del objeto criptográfico asociado a un token de seguridad previamente liberado.
cbLabel	Longitud de la etiqueta en bytes.
pLabel	Etiqueta.
cbNonce	Longitud en bytes del valor de seguridad (nonce).
pNonce	Valor de seguridad (nonce).
derivedKeyLength	Longitud deseada de la clave derivada.
offset	El desplazamiento del hash generado a partir de la etiqueta y el valor de seguridad (nonce) de los que se debe extraer la clave generada.
algId	Identificador URI de cadena que identifica el algoritmo de derivación de clave que se debe utilizar. PSHA1 es el único algoritmo admitido actualmente.
pcbKey	Longitud de la clave derivada.
ppKey	Puntero a un búfer que contiene la clave derivada. Este búfer se debe liberar después de utilizar la función GlobalFree.

Valor de propiedad y valor devuelto

HRESULT.

Requisitos

Windows Vista

Encabezado: declarado en infocard.h.

Biblioteca: utilice infocardapi.lib.

Consulte también

Conceptos

HRESULTS devuelto

Footer image

Enviar comentarios sobre este tema a Microsoft.

Compartir a través de