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

El método GetCspStatusFromOperations crea un objeto ICspStatus para el primer algoritmo admitido que es coherente con la firma, el cifrado, el hash o la operación de cifrado especificadas.

Syntax

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

Parámetros

[in, optional] pAlgorithm

Puntero a una interfaz IObjectId que representa un OID de algoritmo. Este parámetro es opcional y se puede NULL.

• Si especifica un OID y establece el parámetro Operationsen XCN_NCRYPT_SIGNATURE_OPERATION y combina esta marca con XCN_NCRYPT_EXACT_MATCH_OPERATION o XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, se usa el primer algoritmo de firma, si existe, que coincide con el OID.
• Si especifica un OID pero no establece el parámetro Operations en XCN_NCRYPT_SIGNATURE_OPERATION, o establece XCN_NCRYPT_SIGNATURE_OPERATION pero no lo combina con XCN_NCRYPT_EXACT_MATCH_OPERATION o XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, se usa el primer algoritmo que se puede usar para firmar o cifrar.
• Si no especifica un OID, se usa el primer algoritmo compatible con las marcas especificadas en el parámetro Operations .

[in] Operations

Valor de enumeración AlgorithmOperationFlags que identifica el tipo de algoritmo que se va a recuperar. Se debe especificar uno de los siguientes valores:

• XCN_NCRYPT_CIPHER_OPERATION
• XCN_NCRYPT_HASH_OPERATION
• XCN_NCRYPT_SIGNATURE_OPERATION
• XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
• XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

Puede refinar las características de búsqueda mediante la combinación de una de las marcas anteriores con una de las siguientes:

• XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
• XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
• XCN_NCRYPT_EXACT_MATCH_OPERATION

Si establece las marcas de preferencias XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION o XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, tampoco puede especificar ninguna de las siguientes opciones:

• XCN_NCRYPT_CIPHER_OPERATION
• XCN_NCRYPT_HASH_OPERATION

[out] ppValue

Dirección de una variable que recibe un puntero a una interfaz ICspStatus .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Observaciones

Un objeto ICspStatus contiene información de estado sobre un proveedor criptográfico. Cada objeto se inicializa para un algoritmo específico admitido por el proveedor. Si no especifica un algoritmo en el parámetro pAlgorithm , se elige el primer algoritmo compatible con las operaciones permitidas para crear el objeto ICspStatus .

Requisitos

Consulte también

ICspInformation