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

  • Artículo

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.

Sintaxis

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 puede ser NULL.

  • Si especifica un OID y establece el parámetro Operations en 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 valores siguientes:

  • 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 combinando 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 preferencia de XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION o XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, tampoco puede especificar una 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 realiza 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 los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código o valor devuelto Descripción
CERTSRV_E_PROPERTY_EMPTY
 No se encontró el objeto ICspStatus .
OLE_E_BLANK
 El objeto ICspInformation no se ha inicializado.

Comentarios

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 admitido coherente con las operaciones permitidas para crear el objeto ICspStatus .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

ICspInformation