IAlternativeName：：InitializeFromString 方法 (certenroll.h)
InitializeFromString方法會從包含電子郵件地址的字串、網域名稱系統 (DNS) 名稱、URL、已註冊的物件識別碼 (OID) 或使用者主體名稱 (UPN) ，初始化物件識別碼。
語法
HRESULT InitializeFromString(
[in] AlternativeNameType Type,
[in] BSTR strValue
);
參數
[in] Type
AlternativeNameType列舉值，識別strValue參數中包含的輸入字串所代表的名稱類型。 這必須是下列其中一個值。
[in] strValue
包含名稱的 BSTR 變數。
傳回值
如果函式成功，函式會傳回 S_OK。
如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。
備註
如果您使用這個方法來指定 UPN，UPN 會與 XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.2.3) OID 相關聯，而且可辨別編碼規則 (DER) 編碼。 您可以呼叫 RawData 屬性來擷取編碼的位元組陣列。 您可以呼叫 ObjectId 屬性來擷取 OID。
如果您使用這個方法來指定下列任何名稱類型，方法會 傳回E_INVALIDARG。
| 值 | Description |
|---|---|
| XCN_CERT_ALT_NAME_UNKNOWN | 無法識別名稱類型。 |
| XCN_CERT_ALT_NAME_OTHER_NAME | 名稱是由 OID 和位元組陣列所組成。 |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | 此名稱是 X.500 目錄名稱。 |
| XCN_CERT_ALT_NAME_IP_ADDRESS | 名稱是 IP 位址。 |
| XCN_CERT_ALT_NAME_GUID | 此名稱為 GUID。 |
您可以使用 InitializeFromOtherName 方法來指定 OID 和對應的名稱字串，而且您可以使用 InitializeFromRawData 方法來指定 GUID、IP 位址或 X.500 目錄名稱。
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | certenroll.h |
| Dll | CertEnroll.dll |