Win32 API 日本語リファレンス
ホームSystem.AddressBook › ERROR_NOTIFICATION

ERROR_NOTIFICATION

構造体
サイズx64: 32 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
cbEntryIDDWORD4+0+0lpEntryID が指すエントリIDのサイズをバイト単位で示す。
lpEntryIDENTRYID*8/4+8+4エラーが発生したオブジェクトのエントリIDへのポインター。
scodeINT4+16+8エラーを示すステータスコード(SCODE)。
ulFlagsDWORD4+20+12通知の文字幅などを示すフラグ。
lpMAPIErrorMAPIERROR*8/4+24+16詳細なエラー情報を持つMAPIERROR構造体へのポインター。NULL可。

公式ドキュメント

適用対象: Outlook 2013 | Outlook 2016

重大なエラーに関連する情報を記述します。これによってエラー通知が生成されます。

プロパティ
ヘッダー ファイル:
Mapidefs.h
typedef struct _ERROR_NOTIFICATION
{
  ULONG cbEntryID;
  LPENTRYID lpEntryID;
  SCODE scode;
  ULONG ulFlags;
  LPMAPIERROR lpMAPIError;
} ERROR_NOTIFICATION;

解説(Remarks)

ERROR_NOTIFICATION 構造体は、NOTIFICATION 構造体の info メンバーに含まれる構造体の共用体のメンバーの 1 つです。NOTIFICATION 構造体の info メンバーに ERROR_NOTIFICATION 構造体が格納されている場合、NOTIFICATION 構造体の ulEventType メンバーには fnevCriticalError が設定されます。

cbEntryID メンバーと lpEntryID メンバーの値は NULL になることがあります。

通知の詳細については、次の表に示すトピックを参照してください。

トピック 説明
Event Notification in MAPI
通知と通知イベントの全般的な概要です。
Handling Notifications
クライアントが通知をどのように処理すべきかについての解説です。
Supporting Event Notification
サービス プロバイダーが IMAPISupport メソッドを使用して通知を生成する方法についての解説です。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

各言語での定義

#include <windows.h>

// ERROR_NOTIFICATION  (x64 32 / x86 20 バイト)
typedef struct ERROR_NOTIFICATION {
    DWORD cbEntryID;
    ENTRYID* lpEntryID;
    INT scode;
    DWORD ulFlags;
    MAPIERROR* lpMAPIError;
} ERROR_NOTIFICATION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ERROR_NOTIFICATION
{
    public uint cbEntryID;
    public IntPtr lpEntryID;
    public int scode;
    public uint ulFlags;
    public IntPtr lpMAPIError;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ERROR_NOTIFICATION
    Public cbEntryID As UInteger
    Public lpEntryID As IntPtr
    Public scode As Integer
    Public ulFlags As UInteger
    Public lpMAPIError As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class ERROR_NOTIFICATION(ctypes.Structure):
    _fields_ = [
        ("cbEntryID", wintypes.DWORD),
        ("lpEntryID", ctypes.c_void_p),
        ("scode", ctypes.c_int),
        ("ulFlags", wintypes.DWORD),
        ("lpMAPIError", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct ERROR_NOTIFICATION {
    pub cbEntryID: u32,
    pub lpEntryID: *mut core::ffi::c_void,
    pub scode: i32,
    pub ulFlags: u32,
    pub lpMAPIError: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type ERROR_NOTIFICATION struct {
	cbEntryID uint32
	lpEntryID uintptr
	scode int32
	ulFlags uint32
	lpMAPIError uintptr
}
type
  ERROR_NOTIFICATION = record
    cbEntryID: DWORD;
    lpEntryID: Pointer;
    scode: Integer;
    ulFlags: DWORD;
    lpMAPIError: Pointer;
  end;
const ERROR_NOTIFICATION = extern struct {
    cbEntryID: u32,
    lpEntryID: ?*anyopaque,
    scode: i32,
    ulFlags: u32,
    lpMAPIError: ?*anyopaque,
};
type
  ERROR_NOTIFICATION {.bycopy.} = object
    cbEntryID: uint32
    lpEntryID: pointer
    scode: int32
    ulFlags: uint32
    lpMAPIError: pointer
struct ERROR_NOTIFICATION
{
    uint cbEntryID;
    void* lpEntryID;
    int scode;
    uint ulFlags;
    void* lpMAPIError;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ERROR_NOTIFICATION サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; cbEntryID : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpEntryID : ENTRYID* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; scode : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ulFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpMAPIError : MAPIERROR* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ERROR_NOTIFICATION サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbEntryID : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; lpEntryID : ENTRYID* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; scode : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ulFlags : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpMAPIError : MAPIERROR* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ERROR_NOTIFICATION
    #field int cbEntryID
    #field intptr lpEntryID
    #field int scode
    #field int ulFlags
    #field intptr lpMAPIError
#endstruct

stdim st, ERROR_NOTIFICATION        ; NSTRUCT 変数を確保
st->cbEntryID = 100
mes "cbEntryID=" + st->cbEntryID