ホーム › Networking.WindowsWebServices › WS_ERROR_PROPERTY_ID

WS_ERROR_PROPERTY_ID

列挙型

基底型i4

メンバー 3

名前 10進 16進説明

WS_ERROR_PROPERTY_STRING_COUNT

0x0

名前	10進	16進	説明
WS_ERROR_PROPERTY_STRING_COUNT	0	0x0	エラーオブジェクト内で利用できるエラー文字列 (ULONG) の数です。エラー文字列は WsAddErrorString を使用して追加できます。エラーオブジェクトに WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE が存在する場合、対応するエラーテキストが追加の文字列として、返されるエラー文字列の数に加算されます。 `このプロパティは読み取り専用です。`
WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE	1	0x1	関数から返されたエラーが標準の WS_E_* エラーのいずれかにマップされた場合、このプロパティには元の実装固有のエラーコードが格納されます。元のエラーコードは、WWSAPI が使用する基盤ライブラリの特定の実装およびバージョンに固有である点に注意してください。ライブラリは変更される可能性があるため、常に同じ値のままであると想定しないでください。このエラーを公開する主な目的は診断であり、アプリケーションはこのエラーの原因となった基盤ライブラリの元のエラーコードを確認できます。実装固有のエラーコードに基づいて特定の処理を行うアプリケーションは、実装が変更されたときに正しく動作しなくなる可能性があります。エラーが実装固有の値から標準のエラーにマップされなかった場合、このプロパティの値は NOERROR になります。既定値は NOERROR です。
WS_ERROR_PROPERTY_LANGID	2	0x2	エラーオブジェクト内の言語に依存する情報の言語を識別します。この値を 0 にすることはできません。この値は、エラーオブジェクトが最初に作成されたとき、または WsResetError を使用してリセットされた後にのみ設定できます。

エラーオブジェクト内で利用できるエラー文字列 (ULONG) の数です。エラー文字列は WsAddErrorString を使用して追加できます。エラーオブジェクトに WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE が存在する場合、対応するエラーテキストが追加の文字列として、返されるエラー文字列の数に加算されます。

                このプロパティは読み取り専用です。

WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE

0x1

関数から返されたエラーが標準の WS_E_* エラーのいずれかにマップされた場合、このプロパティには元の実装固有のエラーコードが格納されます。

元のエラーコードは、WWSAPI が使用する基盤ライブラリの特定の実装およびバージョンに固有である点に注意してください。ライブラリは変更される可能性があるため、常に同じ値のままであると想定しないでください。

このエラーを公開する主な目的は診断であり、アプリケーションはこのエラーの原因となった基盤ライブラリの元のエラーコードを確認できます。

実装固有のエラーコードに基づいて特定の処理を行うアプリケーションは、実装が変更されたときに正しく動作しなくなる可能性があります。

エラーが実装固有の値から標準のエラーにマップされなかった場合、このプロパティの値は NOERROR になります。

既定値は NOERROR です。

WS_ERROR_PROPERTY_LANGID

0x2

エラーオブジェクト内の言語に依存する情報の言語を識別します。

この値を 0 にすることはできません。

この値は、エラーオブジェクトが最初に作成されたとき、または WsResetError を使用してリセットされた後にのみ設定できます。

公式ドキュメント

エラーに関連付けられた一連のプロパティ値です。これらは WsGetErrorProperty および WsSetErrorProperty を使用して設定および取得します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum WS_ERROR_PROPERTY_ID : int {
    WS_ERROR_PROPERTY_STRING_COUNT = 0,
    WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1,
    WS_ERROR_PROPERTY_LANGID = 2
} WS_ERROR_PROPERTY_ID;

public enum WS_ERROR_PROPERTY_ID : int
{
    WS_ERROR_PROPERTY_STRING_COUNT = 0,
    WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1,
    WS_ERROR_PROPERTY_LANGID = 2,
}

Public Enum WS_ERROR_PROPERTY_ID As Integer
    WS_ERROR_PROPERTY_STRING_COUNT = 0
    WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1
    WS_ERROR_PROPERTY_LANGID = 2
End Enum

import enum

class WS_ERROR_PROPERTY_ID(enum.IntEnum):
    WS_ERROR_PROPERTY_STRING_COUNT = 0
    WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1
    WS_ERROR_PROPERTY_LANGID = 2

// WS_ERROR_PROPERTY_ID
pub const WS_ERROR_PROPERTY_STRING_COUNT: i32 = 0;
pub const WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE: i32 = 1;
pub const WS_ERROR_PROPERTY_LANGID: i32 = 2;

// WS_ERROR_PROPERTY_ID
const (
	WS_ERROR_PROPERTY_STRING_COUNT int32 = 0
	WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE int32 = 1
	WS_ERROR_PROPERTY_LANGID int32 = 2
)

const
  WS_ERROR_PROPERTY_STRING_COUNT = 0;
  WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1;
  WS_ERROR_PROPERTY_LANGID = 2;

// WS_ERROR_PROPERTY_ID
pub const WS_ERROR_PROPERTY_STRING_COUNT: i32 = 0;
pub const WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE: i32 = 1;
pub const WS_ERROR_PROPERTY_LANGID: i32 = 2;

const
  WS_ERROR_PROPERTY_STRING_COUNT* = 0
  WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE* = 1
  WS_ERROR_PROPERTY_LANGID* = 2

enum WS_ERROR_PROPERTY_ID : int {
    WS_ERROR_PROPERTY_STRING_COUNT = 0,
    WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE = 1,
    WS_ERROR_PROPERTY_LANGID = 2,
}

#define global WS_ERROR_PROPERTY_STRING_COUNT        0x0
#define global WS_ERROR_PROPERTY_ORIGINAL_ERROR_CODE 0x1
#define global WS_ERROR_PROPERTY_LANGID              0x2