Metodo ICspInformation::GetCspStatusFromOperations (certenroll.h)

  • Articolo

Il metodo GetCspStatusFromOperations crea un oggetto ICspStatus per il primo algoritmo supportato coerente con la firma, la crittografia, l'hashing o l'operazione di crittografia specificati.

Sintassi

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

Parametri

[in, optional] pAlgorithm

Puntatore a un'interfaccia IObjectId che rappresenta un OID dell'algoritmo. Questo parametro è facoltativo e può essere NULL.

  • Se si specifica un OID e si imposta il parametro Operations su XCN_NCRYPT_SIGNATURE_OPERATION e si combina questo flag con XCN_NCRYPT_EXACT_MATCH_OPERATION o XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, il primo algoritmo di firma, se presente, corrispondente all'OID.
  • Se si specifica un OID ma non si imposta il parametro Operations su XCN_NCRYPT_SIGNATURE_OPERATION oppure si imposta XCN_NCRYPT_SIGNATURE_OPERATION ma non lo si combina con XCN_NCRYPT_EXACT_MATCH_OPERATION o XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, viene usato il primo algoritmo che può essere usato per la firma o la crittografia.
  • Se non si specifica un OID, viene usato il primo algoritmo supportato coerente con i flag specificati nel parametro Operations .

[in] Operations

Valore di enumerazione AlgorithmOperationFlags che identifica il tipo di algoritmo da recuperare. È necessario specificare uno dei valori seguenti:

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION
  • XCN_NCRYPT_SIGNATURE_OPERATION
  • XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
  • XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION

È possibile perfezionare le caratteristiche di ricerca combinando uno dei flag precedenti con uno dei seguenti:

  • XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
  • XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
  • XCN_NCRYPT_EXACT_MATCH_OPERATION

Se si impostano i flag di preferenza XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION o XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, non è anche possibile specificare uno dei seguenti elementi:

  • XCN_NCRYPT_CIPHER_OPERATION
  • XCN_NCRYPT_HASH_OPERATION

[out] ppValue

Indirizzo di una variabile che riceve un puntatore a un'interfaccia ICspStatus .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito Descrizione
CERTSRV_E_PROPERTY_EMPTY
 Impossibile trovare l'oggetto ICspStatus .
OLE_E_BLANK
 L'oggetto ICspInformation non è stato inizializzato.

Commenti

Un oggetto ICspStatus contiene informazioni sullo stato su un provider di crittografia. Ogni oggetto viene inizializzato per un algoritmo specifico supportato dal provider. Se non si specifica un algoritmo nel parametro pAlgorithm , il primo algoritmo supportato coerente con le operazioni consentite viene scelto per creare l'oggetto ICspStatus .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certenroll.h
DLL CertEnroll.dll

Vedi anche

ICspInformation