Metodo ICertPropertyFriendlyName::Initialize (certenroll.h)
Il metodo Initialize inizializza l'oggetto dal nome visualizzato del certificato. Questo metodo è abilitato per il Web.
Sintassi
HRESULT Initialize(
[in] BSTR strFriendlyName
);
Parametri
[in] strFriendlyName
Variabile BSTR che contiene il nome. La lunghezza della stringa non può superare i 260 caratteri.
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 solo, quelli nella tabella seguente. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.
| Codice/valore restituito | Descrizione |
|---|---|
|
L'oggetto è già inizializzato. |
|
La lunghezza della stringa supera i 260 caratteri. |
Osservazioni
In genere, si specifica il nome visualizzato in un'interfaccia utente o dalla riga di comando prima di iniziare il processo di registrazione in modo che il nome possa essere associato al certificato fittizio nell'archivio richieste. Per recuperare il valore e usarlo qui, chiamare il CertificateFriendlyName nell'interfaccia IX509Enrollment.
Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. Chiamare la proprietà FriendlyName per recuperare il nome visualizzato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2008 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione | certenroll.h |
| dll | CertEnroll.dll |