Metodo ICertSrvSetup::SetCADistinguishedName (casetup.h)

Articolo
08/22/2023

Il metodo SetCADistinguishedName imposta un nome comune dell'autorità di certificazione (CA) e un suffisso di nome distinto facoltativo.

Sintassi

HRESULT SetCADistinguishedName(
  [in] const BSTR   bstrCADN,
  [in] VARIANT_BOOL bIgnoreUnicode,
  [in] VARIANT_BOOL bOverwriteExistingKey,
  [in] VARIANT_BOOL bOverwriteExistingCAInDS
);

Parametri

[in] bstrCADN

Stringa contenente il nome di una CA nel formato CommonName,DistinguishedNameSuffix, dove la virgola (,) e DistinguishedNameSuffix sono facoltative.

La tabella seguente descrive un esempio di nome distinto, incluso il suffisso di nome distinto facoltativo, per il computer MyServer.

Valore	Significato
CN=mydomain-MyServer-CA	Nome comune per il computer MyServer che appartiene al dominio MyDomain .
DC=MyDomain,DC=MyCompany,DC=com	Suffisso di nome distinto (facoltativo)
CN=MyDomain-MyServer-CA,DC=MyDomain,DC=MyCompany,DC=com	Nome distinto, incluso il suffisso facoltativo

[in] bIgnoreUnicode

Valore che indica se consentire la codifica Unicode delle informazioni sul nome. Un valore di VARIANT_TRUE abilita la codifica Unicode.

[in] bOverwriteExistingKey

Valore che indica se consentire il nome in bstrCADN, anche se esiste una chiave privata con lo stesso nome nel computer. Un valore di VARIANT_TRUE consente al metodo di sovrascrivere la chiave esistente.

[in] bOverwriteExistingCAInDS

Valore che indica se consentire il nome in bstrCADN, anche se esiste una CA con lo stesso nome distinto nel servizio directory. Un valore di VARIANT_TRUE consente al metodo di sovrascrivere la voce del servizio directory esistente.

Valore restituito

nessuno

Osservazioni

Al termine dell'operazione, il metodo SetCADistinguishedName modifica i valori delle proprietà ENUM_SETUPPROP_CANAME e ENUM_SETUPPROP_CADSSUFFIX per riflettere il nome bstrCADN . Per altre informazioni sulle proprietà di installazione, vedere CASetupProperty.

In caso di errore, il metodo SetCADistinguishedName potrebbe impostare informazioni aggiuntive sugli errori nelle proprietà CAErrorId e CAErrorString .

Se viene usata una chiave esistente e il relativo certificato associato per configurare la CA, questo metodo non deve essere chiamato. Se viene usata una chiave esistente per configurare la CA, senza usare il certificato associato, il nome comune in bstrCADN deve corrispondere al nome contenitore crittografatodella chiave .

Se bstrCADN include la codifica UTF8, impostare il flag appropriato in CAPolicy.inf e inserirlo nel %windir%.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	casetup.h
DLL	Certocm.dll

Vedi anche

ICertSrvSetup

Condividi tramite