IeXdi2EnumCpuRegs::GetNext (Windows Embedded CE 6.0)
1/5/2010
This method retrieves a pointer to the next CPU register information element in the enumerated list.
Syntax
HRESULT GetNext(
CPU_REG_STRUCT* psCpuRegs
);
Parameters
psCpuRegs
[out] Pointer to the CPU_REG_STRUCT structure.The buffer for this value is allocated by CoTaskMemAlloc.
Return Value
The following table shows the return values for this method.
| Value | Description |
|---|---|
S_OK |
Indicates the function was successful. |
E_FAIL |
Indicates an unspecified failure. |
EXDI_E_COMMUNICATION |
Indicates a communication error between host driver and debugging target. |
Remarks
To avoid resource leaking, use CoTaskMemFree to free the task memory used by the buffer for the szRegName member of CPU_REG_STRUCT that this function points to with psCpuRegs.
The following example shows how you might use CoTaskMemFree to release the memory held for the return buffers.
CPU_REG_STRUCT szRegName;
HRESULT hr = pieXdi2EnumCpuRegs->GetNext (&szRegName);
if (SUCCEEDED (hr))
{
// Use register info ...
CoTaskMemFree (CpuReg.szRegName);
CpuReg.szRegName= 0;
}
Requirements
| Header | eXDI2.h |
| Library | ole32.lib, oleaut32.lib |
| Windows Embedded CE | Windows CE 5.0 and later |