IeXdi2EnumCpuRegs::GetNext (Windows CE 5.0)
This method retrieves a pointer to the next CPU register information element in the enumerated list.
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 Values
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
OS Version: Windows CE 5.0 and later.
Header: eXDI2.h.
Link Library: ole32.lib, oleaut32.lib.
See Also
Send Feedback on this topic to the authors