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 contenente 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 sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Codice/valore restituito	Descrizione
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L'oggetto è già inizializzato.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)	La lunghezza della stringa supera i 260 caratteri.

Commenti

In genere, specificare il nome visualizzato in un'interfaccia utente o dalla riga di comando prima di avviare il processo di registrazione in modo che il nome possa essere associato al certificato fittizio nell'archivio richieste. Per recuperare tale valore e usarlo qui, chiamare CertificateFriendlyName nell'interfaccia IX509Enrollment .

Chiamare il metodo SetValueOnCertificate per associare la proprietà a un certificato. Chiamare la proprietà FriendlyName per recuperare il nome visualizzato.

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

ICertProperties

ICertProperty

ICertPropertyDescription

ICertPropertyFriendlyName