Share via


IOsAxsModule::GetCvDebugInfo (Windows Embedded CE 6.0)

1/5/2010

This method returns the signature used to do a debug symbol match.

This method replaces IOsAxsModule::GetAllRoutineData. GetAllRoutineData is deprecated.

Syntax

HRESULT GetCvDebugInfo(
  DWORD* pdwPdbFormat,
  GUID* pguidPdbSig,
  DWORD* pdwPdbAge,
  LPOLESTR* szPdbName
);

Parameters

  • pdwPdbFormat
    Format of the PDB file. Supported values are 'NB10' and 'RSDS'
  • pguidPdbSig
    A unique signature that associates a binary EXE or DLL with a PDB symbol file.
  • pdwPdbAge
    A unique signature that associates a binary EXE or DLL with a PDB symbol file.
  • pszPdbPath
    The name of the PDB file that contains the symbol information for this module.

    The buffer for this value is allocated by CoTaskMemAlloc.

Return Value

The following table shows return values for this method.

Value Description

S_OK

Indicates the function was successful.

E_FAIL

Indicates an unspecified failure.

E_NOTIMPL

Indicates the error code is not implemented.

E_INVALIDARG

Indicates one or more invalid arguments.

E_OUTOFMEMORY

Indicates an out of memory error.

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 that this function uses to return the scratch pad, pszPDBName.

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

DWORD pdwPdbFormat;
GUID pguidPdbSig;
DWORD pdwPdbAge;
LPOLESTR pszPdbPath;
HRESULT hr = piOsAxsModule->GetCvDebugInfo (&pdwPdbFormat, &pguidPdbSig,
        &pdwPdbAge, &pszPdbPath);
if (SUCCEEDED (hr))
{
    CoTaskMemFree (pszPdbPath);
    pszPdbPath = 0;
}

Requirements

Header IOsAccess.h
Library ole32.lib, oleaut32.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IOsAxsModule
IOsAxs Interfaces