estrutura CRYPT_OID_INFO (wincrypt.h)

A estrutura CRYPT_OID_INFO contém informações sobre um OID (identificador de objeto ). Essas estruturas fornecem a relação entre um identificador OID, seu nome, seu grupo e outras informações sobre o OID. Essas estruturas podem ser listadas usando a função CryptEnumOIDInfo . Novos CRYPT_OID_STRUCTURES podem ser adicionados usando a função CryptRegisterOIDInfo .

Sintaxe

typedef struct _CRYPT_OID_INFO {
  DWORD           cbSize;
  LPCSTR          pszOID;
  LPCWSTR         pwszName;
  DWORD           dwGroupId;
  union {
    DWORD  dwValue;
    ALG_ID Algid;
    DWORD  dwLength;
  } DUMMYUNIONNAME;
  CRYPT_DATA_BLOB ExtraInfo;
  LPCWSTR         pwszCNGAlgid;
  LPCWSTR         pwszCNGExtraAlgid;
} CRYPT_OID_INFO, *PCRYPT_OID_INFO;

Membros

cbSize

O tamanho, em bytes, dessa estrutura.

pszOID

A OID associada a essas informações de OID.

pwszName

O nome de exibição associado a um OID.

dwGroupId

O valor do identificador de grupo associado a essas informações de OID.

Esse membro pode ser um dos seguintes identificadores de grupo dwGroupId .

DUMMYUNIONNAME

DUMMYUNIONNAME.dwValue

Um valor numérico associado a essas informações de OID. Esse membro é usado com dwGroupId CRYPT_SIGN_ALG_OID_GROUP_ID.

DUMMYUNIONNAME.Algid

O identificador de algoritmo associado a essas informações de OID.

Este membro aplica-se aos seguintes valores de dwGroupId:

• CRYPT_HASH_ALG_OID_GROUP_ID
• CRYPT_ENCRYPT_ALG_OID_GROUP_ID
• CRYPT_PUBKEY_ALG_OID_GROUP_ID
• CRYPT_SIGN_ALG_OID_GROUP_ID

DUMMYUNIONNAME.dwLength

Este membro não é implementado. Está sempre definido como zero.

ExtraInfo

Informações extras usadas para localizar ou registrar informações de OID. Este membro aplica-se aos seguintes valores de dwGroupId:

• CRYPT_PUBKEY_ALG_OID_GROUP_ID
• CRYPT_SIGN_ALG_OID_GROUP_ID
• CRYPT_RDN_ATTR_OID_GROUP_ID

Os OIDs no grupo OID CRYPT_ENCRYPT_ALG_OID_GROUP_ID têm um comprimento de bit definido para os algoritmos AES no membro DWORD[0] do membro ExtraInfo.

Os OIDs no grupo CRYPT_PUBKEY_ALG_OID_GROUP_ID têm um sinalizador definido no membro DWORD[0] do membro ExtraInfo.

Os OIDs nas chaves públicas do nome da curva ECC, por exemplo, szOID_ECC_CURVE_P256 ("1.2.840.10045.3.1.7"), tem um sinalizador definido no membro DWORD[0], um valor de campo dwMagic BCRYPT_ECCKEY_BLOB definido no membro DWORD[1] e um pouco de comprimento em que o valor BCRYPT_ECCKEY_BLOB cbKey é igual a dwBitLength / 8 + ((dwBitLength % 8) ? 1: 0) definido no membro DWORD[2] do membro ExtraInfo.

Os OIDs no grupo CRYPT_SIGN_ALG_OID_GROUP_ID têm um identificador de algoritmo de chave pública definido no membro DWORD[0], um sinalizador definido no membro DWORD[1] e um tipo de provedor opcional definido no membro DWORD[2] do membro ExtraInfo.

Os OIDs no grupo CRYPT_RDN_ATTR_OID_GROUP_ID têm uma lista terminada em nulo de tipos de valor de atributo RDN aceitáveis definidos em uma matriz de valores DWORD no membro ExtraInfo. Uma lista omitida implica uma matriz de valores em que o primeiro valor na matriz é CERT_RDN_PRINTABLE_STRING, o segundo valor na matriz é CERT_RDN_UNICODE_STRING e o terceiro valor na matriz é zero.

Os valores a seguir são usados para os sinalizadores no membro ExtraInfo .

Uso pós-quântico

CRYPT_PUBKEY_ALG_OID_GROUP_ID tem os seguintes campos ExtraInfo quando usados com OIDs PQ (acima):

CRYPT_SIGN_ALG_OID_GROUP_ID tem os seguintes campos ExtraInfo quando usados com OIDs PQ:

CRYPT_HASH_ALG_OID_GROUP_ID pode ser definido como L"NoHash" para indicar nenhum hash antes da assinatura, e a chave PQ assinará diretamente os bytes ToBeSigned .

pwszCNGAlgid

A cadeia de caracteres do identificador de algoritmo passada para as funções CNG (as funções BCrypt* e NCrypt* que são definidas em Bcrypt.h e Ncrypt.h). As funções CNG usam cadeias de caracteres de identificador de algoritmo, como L"SHA1", em vez das constantes de tipo de dados ALG_ID , como CALG_SHA1. Windows Server 2003 e Windows XP: Este membro não está disponível.

#define CRYPT_OID_INFO_HAS_EXTRA_FIELDS

Este membro aplica-se aos seguintes valores de dwGroupId:

• CRYPT_HASH_ALG_OID_GROUP_ID
• CRYPT_ENCRYPT_ALG_OID_GROUP_ID
• CRYPT_PUBKEY_ALG_OID_GROUP_ID
• CRYPT_SIGN_ALG_OID_GROUP_ID

Defina o membro pwszCNGAlgid como a cadeia de caracteres vazia, L"", para os outros valores de dwGroupId.

O membro pwszCNGAlgid também pode ser definido como um valor de cadeia de caracteres que não é passado diretamente para as funções CNG. A tabela a seguir lista esses valores e seus significados:

pwszCNGExtraAlgid

Uma cadeia de caracteres de algoritmo extra, diferente da cadeia de caracteres no membro pwszCNGAlgid , que pode ser passada para as funções CNG (as funções BCrypt* e NCrypt* definidas em Bcrypt.h e Ncrypt.h).

Windows Server 2003 e Windows XP: Este membro não está disponível.

#define CRYPT_OID_INFO_HAS_EXTRA_FIELDS

Para os algoritmos de assinatura (CRYPT_SIGN_ALG_OID_GROUP_ID), esse membro é a cadeia de caracteres de algoritmo de chave pública a ser passada para as funções CNG.

Para assinaturas ECC, esse membro é o valor de cadeia de caracteres de CRYPT_OID_INFO_ECC_PARAMETERS_ALGORITHM especial.

Para assinaturas não assinadas, esse membro é o valor de cadeia de caracteres de CRYPT_OID_INFO_NO_SIGN_ALGORITHM especial.

Para chaves públicas de nome de curva ECC, por exemplo, szOID_ECC_CURVE_P256 ("1.2.840.10045.3.1.7"), esse é o valor especial da cadeia de caracteres CRYPT_OID_INFO_ECC_PARAMETERS_ALGORITHM.

Para os outros valores de dwGroupId, defina o membro pwszCNGExtraAlgid como a cadeia de caracteres vazia, L"".

Requisitos

Consulte também

CryptFindOIDInfo

CryptRegisterOIDInfo

CryptUnregisterOIDInfo