Método IObjectId::GetAlgorithmName (certenroll.h)

O método GetAlgorithmName recupera o nome de exibição associado a um OID (identificador de objeto de algoritmo).

Sintaxe

HRESULT GetAlgorithmName(
  [in]  ObjectIdGroupId        GroupId,
  [in]  ObjectIdPublicKeyFlags KeyFlags,
  [out] BSTR                   *pstrAlgorithmName
);

Parâmetros

[in] GroupId

Um valor de enumeração ObjectIdGroupId que especifica o grupo OID a ser pesquisado. Isso pode ser qualquer um dos seguintes grupos de algoritmos:

• XCN_CRYPT_HASH_ALG_OID_GROUP_ID
• XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID
• XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID
• XCN_CRYPT_SIGN_ALG_OID_GROUP_ID

• XCN_CRYPT_RDN_ATTR_OID_GROUP_ID
• XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID
• XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID
• XCN_CRYPT_POLICY_OID_GROUP_ID
• XCN_CRYPT_TEMPLATE_OID_GROUP_ID

[in] KeyFlags

Um valor de enumeração ObjectIdPublicKeyFlags que especifica se um algoritmo de assinatura ou criptografia deve ser pesquisado. Esse valor pode ser um dos seguintes:

• XCN_CRYPT_OID_INFO_PUBKEY_ANY
• XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
• XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG

[out] pstrAlgorithmName

Ponteiro para uma variável BSTR que contém o nome.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

Você pode usar a constante XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID para criar um valor de parâmetro GroupId que leva em conta o tamanho da chave para algoritmos que podem ser identificados por um comprimento de bit variável. Por exemplo, para inicializar um objeto IObjectId de um algoritmo AES de 192 bits, especifique "AES" para o parâmetro strAlgorithmName , mova o comprimento para a esquerda em 16 e execute uma combinação bit a bit-OR no comprimento do bit deslocado e XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID.

Se você definir o parâmetro GroupId como algo diferente de XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID, especifique XCN_CRYPT_OID_INFO_PUBKEY_ANY para o parâmetro KeyFlags .

Requirements

Consulte também

IObjectId