iOpcFactory::CreatePartUri 方法 (msopc.h)
建立代表元件名稱的元件 URI 物件。
語法
HRESULT CreatePartUri(
[in] LPCWSTR pwzUri,
[out, retval] IOpcPartUri **partUri
);
參數
[in] pwzUri
URI,表示元件相對於包含元件的根目錄的位置。
[out, retval] partUri
元件 URI 物件的 IOpcPartUri 介面指標。 此物件代表衍生自 pwzUri 中傳遞之 URI 的元件名稱。
元件名稱必須符合 OPC 中指定的語法。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼/值 | 描述 |
---|---|
|
此方法已成功。 |
|
至少有一個 pwzUri 和 partUri 參數為 NULL。 |
|
元件名稱不能是空字串 “ ” |
|
元件名稱不能是 『/』。 |
|
元件名稱不能以 「「「開頭」。 |
|
元件名稱不能以 『/』 結尾。 |
|
元件名稱不能以 『.』 結尾。 |
|
元件名稱不能有任何以 '.' 結尾的區段。 |
|
元件名稱不能有片段元件。 片段元件前面會加上 『#』 字元,如 RFC 3986:URI 一般語法中所述。 |
|
元件名稱不能是關聯性元件的名稱,該部分會指出另一個關聯性元件做為內含關聯性的來源。 |
|
元件名稱不能是絕對 URI。 絕對 URI 以架構元件開頭,後面接著 “:”,如 RFC 3986:URI 一般語法中所述。 |
|
CreateUri 函式中的 HRESULT 錯誤碼。 |
|
來自 WinINet API 的 HRESULT 錯誤碼。 |
備註
舊版 Windows 的支援
此方法的行為和效能在所有支援的 Windows 版本上都相同。 如需詳細資訊,請參閱使用封裝 API 和適用於 Windows Vista 的平臺更新 使用者入門。執行緒安全性
封裝物件不是安全線程。
如需詳細資訊,請參閱使用封裝 API 使用者入門。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [僅限桌面] |
目標平台 | Windows |
標頭 | msopc.h |
另請參閱
外部資源
概觀
參考