Metodo ISCrdEnr::setSigningCertificate

  • Articolo

Il metodo setSigningCertificate specifica un certificato di firma (noto anche come certificato dell'agente di registrazione).

Prima di registrare per conto degli utenti, è necessario selezionare o impostare un certificato di firma. La chiave privata associata a questo certificato di firma viene usata per firmare una richiesta PKCS #7. PkCS #7, a sua volta, contiene la richiesta PKCS #10 dell'utente ,firmata con la chiave privata dell'utente.

Sintassi

HRESULT setSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);


SCrdEnr.setSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

Parametri

dwFlags [in]

Riservato per utilizzi futuri. Impostare questo valore su zero.

bstrCertTemplateName [in]

Nome del modello di certificato per il certificato di firma. È possibile usare il valore "EnrollmentAgent" se è stato ottenuto un certificato EnrollmentAgent.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Prima di registrare per conto di un utente, è prima necessario ottenere un certificato di firma. È possibile ottenere un certificato di firma usando lo snap-in MMC di Gestione certificati. Il metodo setSigningCertificate non ottiene il certificato di firma ma informa il controllo registrazione smart card che in precedenza ottiene il certificato di firma da usare. Il metodo setSigningCertificate cerca l'archivio "My" del chiamante per il certificato di firma più recente corrispondente al modello di certificato specificato da bstrCertTemplateName.

Un'alternativa a setSigningCertificate è ISCrdEnr::setSigningCertificate.

Dopo aver impostato un certificato di firma, il nome può essere recuperato chiamando ISCrdEnr::getSigningCertificateName.

Requisiti

Requisito Valore
Client minimo supportato
 Nessuno supportato
Server minimo supportato
 Windows Server 2003 [solo app desktop]
DLL
Scrdenrl.dll
IID
 IID_ISCrdEnr è definito come 753988a1-1357-436d-9cf5-f089bdd67d64

Vedi anche

ISCrdEnr

ISCrdEnr::getSigningCertificateName