MAPIERROR
適用対象: Outlook 2013 | Outlook 2016
通常、オペレーティング システム、MAPI、またはサービス プロバイダーによって生成されるエラーに関する詳細情報を提供します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapidefs.h |
typedef struct _MAPIERROR
{
ULONG ulVersion;
LPSTR lpszError;
LPSTR lpszComponent;
ULONG ulLowLevelError;
ULONG ulContext;
} MAPIERROR, FAR * LPMAPIERROR;
メンバー
ulVersion
構造体のバージョン番号。 ulVersion メンバーは将来の拡張に使用され、現在 0 として定義されているMAPI_ERROR_VERSIONに設定する必要があります。
lpszError
エラーを説明する文字列へのポインター。 この構造体を使用するメソッドの ulFlags パラメーターが MAPI_UNICODE に設定されている場合、この文字列は Unicode 形式になります。
lpszComponent
エラーを生成したコンポーネントを記述する文字列へのポインター。 この構造体を使用するメソッドの ulFlags パラメーターが MAPI_UNICODE に設定されている場合、この文字列は Unicode 形式になります。
ulLowLevelError
返されるエラーが低レベルの場合にのみ使用される低レベルのエラー値。
ulContext
エラーが発生した場所を識別する lpszComponent メンバーが指すコンポーネント内の場所を表す値。
注釈
MAPIERROR 構造体は、エラー情報を記述するために使用されます。 クライアントとサービス プロバイダーは、IMAPIProp::GetLastError メソッドの lppMAPIError パラメーター内の MAPIERROR 構造体へのポインターを渡します。 GetLastError は 、オブジェクトに発生した前のエラーに関する情報を返します。 GetLastError の呼び出し元は、MAPIFreeBuffer を呼び出すことによって MAPIERROR 構造体のメモリを解放します。
lpszComponent メンバーを使用して、コンポーネントのヘルプ ファイル (存在する場合) をマップできます。 サービス プロバイダーは、ダイアログ ボックスに簡単に表示できるように、コンポーネント文字列のサイズを 30 文字に制限する必要があります。 ulContext メンバーを使用して、一般的なエラーに関するオンライン ヘルプ トピックを参照することもできます。
サービス プロバイダーは詳細なエラー情報を提供する必要がないため、クライアントは、有効なデータを含めるために返される MAPIERROR 構造体のメンバーを想定しないでください。 ただし、少なくとも MAPI では、プロバイダーが lpszComponent および ulContext メンバーの情報を指定することを強くお勧めします。
MAPI でのエラー処理の詳細については、「 エラー処理」を参照してください。