Metodo IEnroll::get_HashAlgorithmWStr (xenroll.h)

  • Articolo

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà HashAlgorithmWStr imposta o recupera solo l'algoritmo di hash delle firme usato per firmare la richiesta di certificazione PKCS #10.

Questa proprietà è stata definita per la prima volta nell'interfaccia IEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_HashAlgorithmWStr(
  LPWSTR *szw
);

Parametri

szw

Valore restituito

nessuno

Osservazioni

Questo algoritmo di hashing della firma non deve essere confuso con l'algoritmo di hashing usato per firmare il certificato. Il controllo di registrazione supporta attualmente qualsiasi OID per gli algoritmi di hashing, oltre ai valori del nome visualizzato seguenti: SHA1 (impostazione predefinita), MD2 e MD5. Quando si recupera questa proprietà, il valore recuperato è in formato OID, ovvero SHA1 viene visualizzato come 1.3.14.3.3.2.29. Quando si imposta questa proprietà, il formato OID corrispondente può essere usato come alternativa al testo visualizzato per i valori descrittivi definiti.

Il controllo Registrazione certificati considera il valore della proprietà HashAlgorithmWStr come suggerimento per l'algoritmo di hash da usare per firmare la richiesta di certificazione PKCS #10. Se il provider di servizi di crittografia supporta l'algoritmo specificato nella proprietà HashAlgorithmWStr , verrà usato l'algoritmo. In caso contrario, il controllo registrazione certificati tenterà di usare SHA1. Se SHA1 non è supportato dal CSP, verrà provato MD5. Se non è supportato SHA1 né MD5, il controllo registrazione certificati tenterà di usare il primo algoritmo hash restituito dal CSP.

La proprietà HashAlgorithmWStr influisce sul comportamento dei metodi seguenti:

Se vengono impostate entrambe le proprietà HashAlgID e HashAlgorithmWStr , l'ultimo aggiornamento specifica quale algoritmo di hashing verrà usato per firmare la richiesta di certificazione PKCS #10.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll

Vedi anche

IEnroll