WsGetMissingMetadataDocumentAddress 函式 (webservices.h)

此函式會傳回中繼資料物件所參考之遺漏檔的位址。

新增至中繼資料物件的每份檔可能包含其他檔的參考。 將檔新增回中繼資料之後,函式可用來尋找下一個遺漏的檔。

注意 如果傳回之遺漏位址的 URL 主機名稱無法驗證為預期的其中一個主機名稱,此函式將會失敗。 預期的主機名稱是下列的聯集:
 

語法

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 指標,當函式失敗時,應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回下列其中一個值。

傳回碼 描述
E_INVALIDARG
一或多個引數無效。
E_OUTOFMEMORY
記憶體不足。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

備註

此函式是否會使用 WS_METADATA_PROPERTY_VERIFY_HOST_NAMES 列舉值來控制傳回的 URL 主機名稱。

主機名稱驗證的目的是確保應用程式不會使用位址,而不知道它來自願意接受中繼資料的來源主機。

規格需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll