Método ICspInformation::GetCspStatusFromOperations (certenroll.h)

  • Artigo

O método GetCspStatusFromOperations cria um objeto ICspStatus para o primeiro algoritmo com suporte consistente com a assinatura, criptografia, hash ou operação de criptografia especificada.

Sintaxe

HRESULT GetCspStatusFromOperations(
  [in, optional] IObjectId               *pAlgorithm,
  [in]           AlgorithmOperationFlags Operations,
  [out]          ICspStatus              **ppValue
);

Parâmetros

[in, optional] pAlgorithm

Ponteiro para uma interface IObjectId que representa um algoritmo OID. Esse parâmetro é opcional e pode ser NULL.

  • Se você especificar um OID e definir o parâmetro Operations como XCN_NCRYPT_SIGNATURE_OPERATION e combinar esse sinalizador com XCN_NCRYPT_EXACT_MATCH_OPERATION ou XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, o primeiro algoritmo de assinatura, se houver, que corresponde ao OID será usado.
  • Se você especificar um OID, mas não definir o parâmetro Operações como XCN_NCRYPT_SIGNATURE_OPERATION ou definir XCN_NCRYPT_SIGNATURE_OPERATION mas não combiná-lo com XCN_NCRYPT_EXACT_MATCH_OPERATION ou XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, o primeiro algoritmo que pode ser usado para assinatura ou criptografia será usado.
  • Se você não especificar um OID, o primeiro algoritmo com suporte consistente com os sinalizadores especificados no parâmetro Operations será usado.

[in] Operations

Um valor de enumeração AlgorithmOperationFlags que identifica o tipo de algoritmo a ser recuperado. Um dos seguintes valores deve ser especificado:

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION
  • XCN_NCRYPT_SIGNATURE_OPERATION
  • XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
  • XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

Você pode refinar as características de pesquisa combinando um dos sinalizadores anteriores com um dos seguintes:

  • XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
  • XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
  • XCN_NCRYPT_EXACT_MATCH_OPERATION

Se você definir os sinalizadores de preferência XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION ou XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, também não poderá especificar um dos seguintes:

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION

[out] ppValue

Endereço de uma variável que recebe um ponteiro para uma interface ICspStatus .

Retornar valor

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 possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado Descrição
CERTSRV_E_PROPERTY_EMPTY
 Não foi possível encontrar o objeto ICspStatus .
OLE_E_BLANK
 O objeto ICspInformation não foi inicializado.

Comentários

Um objeto ICspStatus contém status informações sobre um provedor criptográfico. Cada objeto é inicializado para um algoritmo específico com suporte do provedor. Se você não especificar um algoritmo no parâmetro pAlgorithm , o primeiro algoritmo com suporte consistente com as operações permitidas será escolhido para criar o objeto ICspStatus .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h
DLL CertEnroll.dll

Confira também

ICspInformation