IeXdi2Exec::GetExceptionDescriptionList (Windows Embedded CE 6.0)

1/5/2010

This method returns the supported exception description table.

Syntax

HRESULT GetExceptionDescriptionList(
  [out] DWORD *pdwNbTotalExceptionInList,
  [out, size_is(,* pdwNbTotalExceptionInList)] EXCEPTION_DESCRIPTION_TYPE ** ppedTable
);

Parameters

• pdwNbTotalExceptionInList
  Pointer to the number of EXCEPTION_DESCRIPTION_TYPE elements to be provided in ppedTable.

• ppedTable
  Pointer to the table of EXCEPTION_DESCRIPTION_TYPE elements that associate exception number, name, and debugger action. The buffer for this value is allocated by CoTaskMemAlloc.

Return Value

The following table shows return values for this method.

Remarks

A client such as Platform Builder can use this method to acquire the set of exception codes and corresponding descriptions that can be expected from the eXDI service.

Platform Builder acquires this list when starting the debugger and connecting to the eXDI service.

To avoid resource leaking, use CoTaskMemFree to free the task memory used by the buffer that this function uses to return EXCEPTION_DESCRIPTION_TYPE elements, ppedTable.

The following example shows how you might use CoTaskMemFree to release the memory held for the return buffers.

DWORD dwNbEntries;
EXCEPTION_DESCRIPTION_TYPE *ppedTable;
HRESULT hr = pieXdi2Exec->GetExceptionDescriptionList (&dwNbEntries, &ppedTable);
if (SUCCEEDED (hr))
{
    // Use exception list ..
    CoTaskMemFree (ppedTable);
    ped = 0;
}

Requirements

See Also

Reference

IeXdi2Exec
IeXDI2 Interfaces