WsGetNamespaceFromPrefix 函式 (webservices.h)

  • 發行項

此函式會從其系結的前置詞傳回命名空間。

如果 必要 參數的值設定為 TRUE ，且 Prefix 未系結至任何命名空間，則會傳回 WS_E_INVALID_FORMAT 例外狀況。 (請參閱 Windows Web Services 傳回值.) 如果 必要的 參數為 FALSE，且 Prefix 未系結至 ns 參數將會是 Null 的任何命名空間，且函式會傳回S_FALSE。

語法

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

參數

[in] reader

應該搜尋前置詞的讀取器指標。

[in] prefix

要搜尋之前置詞的指標。

[in] required

如果找不到相符的命名空間，這個布林參數的值會判斷是否應該傳回錯誤。

ns

如果成功，則為前置詞所系結之命名空間的參考。 傳回的值只有在寫入器前進之前才有效。

[in, optional] error

WS_ERROR物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

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

傳回碼 描述
WS_E_INVALID_FORMAT
 輸入資料的格式不正確，或沒有預期的值。

備註

針對前置詞 「xml」，它會傳回命名空間 「 http://www.w3.org/XML/1998/namespace" ;。

針對前置詞 「xmlns」，它會傳回命名空間 「 http://www.w3.org/2000/xmlns/" ;。

規格需求

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