errhandlingapi.h

/******************************************************************************** * * * errhandlingapi.h - ApiSet Contract for api-ms-win-core-errorhandling-l1 * * * * Copyright (c) Microsoft Corporation. All rights reserved. * * * ********************************************************************************/

#ifdef _MSC_VER

#pragma once

#endif // _MSC_VER

#ifndef _ERRHANDLING_H_

#define _ERRHANDLING_H_

#include <apiset.h>

#include <apisetcconv.h>

#include <minwindef.h>

#ifdef __cplusplus

extern

"C"

{

#endif

#pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

// Typedefs

typedef LONG (WINAPI *PTOP_LEVEL_EXCEPTION_FILTER)(

typedef

LONG

(

__stdcall

PTOP_LEVEL_EXCEPTION_FILTER

)(

_In_ struct _EXCEPTION_POINTERS *ExceptionInfo

struct

_EXCEPTION_POINTERS

*ExceptionInfo

);

typedef

PTOP_LEVEL_EXCEPTION_FILTER

LPTOP_LEVEL_EXCEPTION_FILTER

;

// Prototypes

WINBASEAPI

__declspec

(dllimport)

__analysis_noreturn

VOID

void

WINAPI

__stdcall

RaiseException

(

_In_ DWORD dwExceptionCode,

DWORD

dwExceptionCode

_In_ DWORD dwExceptionFlags,

DWORD

dwExceptionFlags

_In_ DWORD nNumberOfArguments,

DWORD

nNumberOfArguments

_In_reads_opt_(nNumberOfArguments) CONST ULONG_PTR* lpArguments

const

ULONG_PTR

lpArguments

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

__callback

WINBASEAPI

__declspec

(dllimport)

LONG

WINAPI

__stdcall

UnhandledExceptionFilter

(

_In_ struct _EXCEPTION_POINTERS* ExceptionInfo

struct

_EXCEPTION_POINTERS

ExceptionInfo

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

LPTOP_LEVEL_EXCEPTION_FILTER

WINAPI

__stdcall

SetUnhandledExceptionFilter

(

_In_opt_ LPTOP_LEVEL_EXCEPTION_FILTER lpTopLevelExceptionFilter

LPTOP_LEVEL_EXCEPTION_FILTER

lpTopLevelExceptionFilter

);

#ifndef _M_CEE_PURE

WINBASEAPI

__declspec

(dllimport)

_Check_return_

_Post_equals_last_error_

DWORD

WINAPI

__stdcall

GetLastError

(

VOID

void

);

#endif

WINBASEAPI

__declspec

(dllimport)

VOID

void

WINAPI

__stdcall

SetLastError

(

_In_ DWORD dwErrCode

DWORD

dwErrCode

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#if (_WIN32_WINNT >= 0x0600)

WINBASEAPI

__declspec

(dllimport)

UINT

WINAPI

__stdcall

GetErrorMode

(

VOID

void

);

#endif // (_WIN32_WINNT >= 0x0600)

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

UINT

WINAPI

__stdcall

SetErrorMode

(

_In_ UINT uMode

UINT

uMode

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#if (_WIN32_WINNT >= 0x0501)

WINBASEAPI

__declspec

(dllimport)

_Ret_maybenull_

PVOID

WINAPI

__stdcall

AddVectoredExceptionHandler

(

_In_ ULONG First,

ULONG

First

_In_ PVECTORED_EXCEPTION_HANDLER Handler

PVECTORED_EXCEPTION_HANDLER

Handler

);

WINBASEAPI

__declspec

(dllimport)

ULONG

WINAPI

__stdcall

RemoveVectoredExceptionHandler

(

_In_ PVOID Handle

PVOID

Handle

);

WINBASEAPI

__declspec

(dllimport)

_Ret_maybenull_

PVOID

WINAPI

__stdcall

AddVectoredContinueHandler

(

_In_ ULONG First,

ULONG

First

_In_ PVECTORED_EXCEPTION_HANDLER Handler

PVECTORED_EXCEPTION_HANDLER

Handler

);

WINBASEAPI

__declspec

(dllimport)

ULONG

WINAPI

__stdcall

RemoveVectoredContinueHandler

(

_In_ PVOID Handle

PVOID

Handle

);

#endif // (_WIN32_WINNT >= 0x0501)

// RC warns because "WINBASE_DECLARE_RESTORE_LAST_ERROR" is a bit long.

#if !defined(RC_INVOKED)

//#if _WIN32_WINNT >= 0x0501 || defined(WINBASE_DECLARE_RESTORE_LAST_ERROR)

#if defined(WINBASE_DECLARE_RESTORE_LAST_ERROR)

WINBASEAPI

VOID

WINAPI

RestoreLastError(

_In_ DWORD dwErrCode

);

typedef VOID (WINAPI* PRESTORE_LAST_ERROR)(DWORD);

#define RESTORE_LAST_ERROR_NAME_A "RestoreLastError"

#define RESTORE_LAST_ERROR_NAME_W L"RestoreLastError"

#define RESTORE_LAST_ERROR_NAME TEXT("RestoreLastError")

#endif #endif

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

VOID

void

WINAPI

__stdcall

RaiseFailFastException

(

_In_opt_ PEXCEPTION_RECORD pExceptionRecord,

PEXCEPTION_RECORD

pExceptionRecord

_In_opt_ PCONTEXT pContextRecord,

PCONTEXT

pContextRecord

_In_ DWORD dwFlags

DWORD

dwFlags

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

VOID

void

WINAPI

__stdcall

FatalAppExitA

(

_In_ UINT uAction,

UINT

uAction

_In_ LPCSTR lpMessageText

LPCSTR

lpMessageText

);

WINBASEAPI

__declspec

(dllimport)

VOID

void

WINAPI

__stdcall

FatalAppExitW

(

_In_ UINT uAction,

UINT

uAction

_In_ LPCWSTR lpMessageText

LPCWSTR

lpMessageText

);

#ifdef UNICODE

#define FatalAppExit FatalAppExitW

#else

#define FatalAppExit FatalAppExitA #endif // !UNICODE

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

DWORD

WINAPI

__stdcall

GetThreadErrorMode

(

VOID

void

);

WINBASEAPI

__declspec

(dllimport)

BOOL

WINAPI

__stdcall

SetThreadErrorMode

(

_In_ DWORD dwNewMode,

DWORD

dwNewMode

_In_opt_ LPDWORD lpOldMode

LPDWORD

lpOldMode

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

VOID

void

WINAPI

__stdcall

TerminateProcessOnMemoryExhaustion

(

_In_ SIZE_T FailedAllocationSize

SIZE_T

FailedAllocationSize

);

#endif // WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

#pragma endregion

#ifdef __cplusplus

}

#endif

#endif // _ERRHANDLING_H_