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.

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

See Also

Reference

IeXdi2EnumCpuRegs
IeXDI2 Interfaces