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 |