WsGetMissingMetadataDocumentAddress 函式 (webservices.h)
此函式會傳回中繼資料物件所參考之遺漏檔的位址。
新增至中繼資料物件的每份檔可能包含其他檔的參考。 將檔新增回中繼資料之後,函式可用來尋找下一個遺漏的檔。
注意 如果傳回之遺漏位址的 URL 主機名稱無法驗證為預期的其中一個主機名稱,此函式將會失敗。 預期的主機名稱是下列的聯集:
- 任何先前傳遞至 WsReadMetadata之 URL 的主機名稱。
- 使用 WS_METADATA_PROPERTY_HOST_NAMES 屬性指定的主機名稱清單。
語法
HRESULT WsGetMissingMetadataDocumentAddress(
[in] WS_METADATA *metadata,
WS_ENDPOINT_ADDRESS **address,
[in, optional] WS_ERROR *error
);
參數
[in] metadata
此參數是 中繼資料物件的指標 ,該物件應具有檔。
address
成功時,此參數會填入遺漏元資料檔案的位址指標,如果沒有遺漏的元資料檔案,則為 Null 。
傳回的位址 URL 完整。
注意 此函式傳回的資料有效,直到釋放或重設中繼資料物件為止。 不應修改資料。
[in, optional] error
此參數是 WS_ERROR 指標,當函式失敗時,應該儲存錯誤的其他資訊。
傳回值
此函式可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
一或多個引數無效。 |
|
記憶體不足。 |
|
此函式可能會傳回上面未列出的其他錯誤。 |
備註
此函式是否會使用 WS_METADATA_PROPERTY_VERIFY_HOST_NAMES 列舉值來控制傳回的 URL 主機名稱。
主機名稱驗證的目的是確保應用程式不會使用位址,而不知道它來自願意接受中繼資料的來源主機。
規格需求
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | webservices.h |
程式庫 | WebServices.lib |
Dll | WebServices.dll |