ICertSrvSetup：：SetCADistinguishedName 方法 (casetup.h)

  • 發行項

SetCADistinguishedName 方法會設定證書頒發機構單位 (CA) 一般名稱和選擇性的辨別名稱後綴。

語法

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

參數

[in] bstrCADN

字串，其中包含 CommonName、DistinguishedNameSuffix 格式為 CA 的名稱，其中逗號 (，) 和 DistinguishedNameSuffix 都是選擇性的。

下表描述電腦 MyServer 的辨別名稱範例，包括選擇性的辨別名稱後綴。

值 意義
CN=mydomain-MyServer-CA
 屬於 MyDomain 網域之 MyServer 計算機的一般名稱。
DC=MyDomain，DC=MyCompany，DC=com
 辨別名稱後綴 (選擇性)
CN=MyDomain-MyServer-CA，DC=MyDomain，DC=MyCompany，DC=com
 辨別名稱，包括選擇性後綴

[in] bIgnoreUnicode

值，指出是否允許名稱資訊的 Unicode 編碼。 VARIANT_TRUE的值會啟用 Unicode 編碼。

[in] bOverwriteExistingKey

值，指出是否允許 bstrCADN 中的名稱，即使計算機上存在具有相同名稱的 私鑰 也一樣。 VARIANT_TRUE值可讓方法覆寫現有的索引鍵。

[in] bOverwriteExistingCAInDS

值，指出是否允許 bstrCADN 中的名稱，即使目錄服務中有具有相同辨別名稱的 CA 也一樣。 VARIANT_TRUE 值可讓 方法覆寫現有的目錄服務專案。

傳回值

無

備註

成功時， SetCADistinguishedName 方法會變更 ENUM_SETUPPROP_CANAME 和 ENUM_SETUPPROP_CADSSUFFIX 屬性值，以反映 bstrCADN 名稱。 如需安裝程式屬性的詳細資訊，請參閱 CASetupProperty。

失敗時， SetCADistinguishedName 方法可能會在 CAErrorId 和 CAErrorString 屬性中設定其他錯誤資訊。

如果使用現有的密鑰及其相關聯的憑證來設定 CA，則不得呼叫這個方法。 如果使用現有的密鑰來設定 CA，而不使用相關聯的憑證， bstrCADN 中的一般名稱必須符合密鑰的 已清理ContainerName 。

如果 bstrCADN 包含 UTF8 編碼，請在 CAPolicy.inf 中設定適當的旗標，並將其放在 %windir% 中。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 casetup.h
Dll Certocm.dll

另請參閱

ICertSrvSetup