Metodo ICspInformation::GetCspStatusFromOperations (certenroll.h)

Articolo
02/23/2024

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

Condividi tramite