Metodo IEnroll::p ut_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 hash della firma 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 put_HashAlgorithmWStr(
  LPWSTR szw
);

Parametri

szw

Valore restituito

nessuno

Osservazioni

Questo algoritmo di hash delle firme non deve essere confuso con l'algoritmo hash usato per firmare il certificato. Il controllo di registrazione supporta attualmente qualsiasi OID per algoritmi hash, 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.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 hint per l'algoritmo hash da usare per firmare la richiesta di certificazione PKCS #10. Se il provider di servizi di crittografia (CSP) 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 provider di servizi di configurazione, verrà provato MD5. Se non è supportato né SHA1 né MD5, il controllo di registrazione certificati tenterà di usare il primo algoritmo hash restituito dal provider di servizi di configurazione.

La proprietà HashAlgorithmWStr influisce sul comportamento dei metodi seguenti:

Se vengono impostate entrambe le proprietà HashAlgID e HashAlgorithmWStr , a seconda dell'ultimo aggiornamento verrà specificato quale algoritmo di hash verrà usato per firmare la richiesta di certificazione PKCS #10.

Requisiti

Requisito Valore
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