共用方式為

IPolicyQualifier：：InitializeEncode 方法 (certenroll.h)

  • 發行項

InitializeEncode 方法會從字串和識別限定符類型的值初始化物件。

語法

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

參數

[in] strQualifier

包含限定符的 BSTR 變數。

[in] Type

PolicyQualifierType 列舉值，指定套用至憑證原則的限定符類型。 這可以是下列其中一個值。

值 意義
PolicyQualifierTypeUnknown
 未指定限定符類型。
PolicyQualifierTypeUrl
 限定符是指向認證練習聲明的 URL， (CPS) ，該聲明已由證書頒發機構單位定義，以概述發行憑證的原則，以及憑證可使用的目的。
PolicyQualifierTypeUserNotice
 限定符是應用程式要向依賴憑證的任何用戶顯示的文字語句。 使用者通知會識別憑證的允許使用。

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼 Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
對象已經初始化。

備註

如果您在 Type 參數中指定 PolicyQualifierTypeUrl，此方法會將 strQualifier 參數中輸入的字串與 XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) 物件標識符 (OID) ，並使用 可辨別編碼規則 (DER) 編碼。 URL 會編碼為 抽象語法表示法 1 (ASN.1) IA5 字串。

如果您在 Type 參數中指定 PolicyQualifierTypeUserNotice，此方法會將 strQualifier 參數中輸入的字元串與 XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE ( 1.3.6.1.5.5.5.7.2.2) OID 建立關聯，並使用 DER 進行編碼。

您可以擷取此物件的下列屬性：

  • ObjectId 屬性會擷取 OID，識別限定符是 CPS 還是使用者通知。
  • Qualifier 屬性會擷取 InitializeEncode 方法之 strQualifier 參數所指定的字串。
  • RawData 屬性會擷取 DER 編碼限定符。
  • Type 屬性會擷取指定限定符類型的 PolicyQualifierType 列舉值。

規格需求

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

另請參閱

IPolicyQualifier