WsCreateError 函式 (webservices.h)

建立可以傳遞至函式以記錄豐富錯誤信息的錯誤物件。

語法

HRESULT WsCreateError(
       const WS_ERROR_PROPERTY *properties,
  [in] ULONG                   propertyCount,
       WS_ERROR                **error
);

參數

properties

包含選擇性錯誤屬性 之WS_ERROR_PROPERTY 結構的陣列。

[in] propertyCount

屬性陣列中的 屬性 數目。

error

成功時,會接收表示所建立錯誤物件之 WS_ERROR 結構位址的指標。

傳回值

如果函式成功,它會傳回NO_ERROR;否則,它會傳回 HRESULT 錯誤碼。

傳回碼 Description
E_INVALIDARG
一或多個引數無效。
E_OUTOFMEMORY
記憶體不足,無法完成作業。
其他錯誤
此函式可能會傳回上述未列出的其他錯誤。

備註

當您不再需要錯誤物件時,請呼叫 WsFreeError 函式來釋放它。

根據預設,錯誤物件中任何語言相依資訊的語言是目前的用戶預設UI語言。 不過,您可以藉由設定 WS_ERROR_PROPERTY_LANGID 屬性來變更語言。 請參閱 WS_ERROR_PROPERTY_ID 列舉。

規格需求

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