Estrutura BLOBHEADER (wincrypt.h)

  • Artigo

A estrutura PUBLICKEYSTRUC , também conhecida como estrutura BLOBHEADER , indica o tipo BLOB de uma chave e o algoritmo que a chave usa. Uma dessas estruturas está localizada no início do membro pbData de cada BLOB de chave.

Essa estrutura não se limita aos BLOBs de chave gerados pelos tipos de provedor PROV_RSA_BASE e PROV_RSA_SIG. O membro pbData de qualquer novo tipo de BLOB de chave deve começar com essa estrutura.

Sintaxe

typedef struct _PUBLICKEYSTRUC {
  BYTE   bType;
  BYTE   bVersion;
  WORD   reserved;
  ALG_ID aiKeyAlg;
} BLOBHEADER, PUBLICKEYSTRUC;

Membros

bType

Contém o tipo de BLOB de chave.

Veja a seguir os valores predefinidos para esse membro. Os CSPs (provedores de serviços criptográficos) podem usar outros identificadores de tipo conforme necessário.

Valor Significado
KEYSTATEBLOB
0xC
 O BLOB é um BLOB de estado de chave.
OPAQUEKEYBLOB
0x9
 A chave é uma chave de sessão.
PLAINTEXTKEYBLOB
0x8
 A chave é uma chave de sessão.
PRIVATEKEYBLOB
0x7
 A chave é um par de chaves pública/privada.
PUBLICKEYBLOB
0x6
 A chave é uma chave pública.
PUBLICKEYBLOBEX
0xA
 A chave é uma chave pública.
SIMPLEBLOB
0x1
 A chave é uma chave de sessão.
SYMMETRICWRAPKEYBLOB
0xB
 A chave é uma chave simétrica.

bVersion

Contém o número de versão do formato BLOB da chave. Por exemplo, se o BLOB for uma chave DSS ( Digital Signature Standard ) versão 3, esse membro conterá 3. O valor mínimo para esse membro é definido pelo identificador CUR_BLOB_VERSION (2).

reserved

Esse membro é reservado para uso futuro e deve ser definido como zero.

aiKeyAlg

Contém um dos valores de ALG_ID que identifica o algoritmo da chave contida pelo BLOB de chave.

Nem todos os identificadores de algoritmo são válidos com todos os tipos de BLOB. Por exemplo, como uma chave RC4 é uma chave de sessão, ela não pode ser exportada para um PUBLICKEYBLOB.

PLAINTEXTBLOBs pode ser usado com qualquer algoritmo ou tipo de combinação de chaves compatível com o CSP em uso. Observe que uma chave 3DES não pode ser importada quando o Provedor Base da Microsoft está em uso.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho wincrypt.h

Confira também

DSSPUBKEY

DSSSEED

RSAPUBKEY