Share via

WsGetPrefixFromNamespace 函式 (webservices.h)

  • 發行項

此函式會傳回命名空間所系結的前置詞。 範圍中可能有一個以上的前置詞，而且此函式可以自由傳回其中任何一個前置詞。

注意 在沒有任何情況下，呼叫端應該相依或預期在傳回多個前置詞時傳回特定的前置詞。
 

如果 必要 參數的值設定為 TRUE ，且命名空間未系結至任何前置詞，則會傳回 WS_E_INVALID_FORMAT 例外狀況。 (請參閱 Windows Web 服務傳回值。) 如果必要 參數為 FALSE，且命名空間未系結至前置 詞參數為NULL 且函式會傳回S_FALSE。

如果 呼叫 WsWriteStartElement ，但專案未認可元素所參考的 Namespaces 和 Prefixes，而且此函式上的任何屬性都無法使用。

語法

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

參數

[in] writer

具有要搜尋之命名空間的寫入器指標。 這必須是 WsCreateWriter 所傳回的有效WS_XML_WRITER物件，而且可能不是 NULL。

[in] ns

要搜尋的命名空間。

[in] required

指出如果找不到相符的前置詞，是否應該傳回錯誤。

prefix

如果必要參數的值為 FALSE 且找不到相符的命名空間，則為系結至命名空間的前置詞參考或 NULL。

注意 傳回的值只有在寫入器前進之前才有效。

 

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據不是預期的格式，或沒有預期的值。

備註

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

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

傳回的前置詞不應該修改，而且只有在寫入器前進之前才有效。

規格需求

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