IDiaEnumDebugStreams::Item
Note
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
Retrieves a debug stream by means of an index or name.
Syntax
HRESULT Item (
VARIANT index,
IDiaEnumDebugStreamData** stream
);
Parameters
index
[in] Index or name of the debug stream to be retrieved. If an integer variant is used, it must be in the range 0 to count-1, where count is as returned by the IDiaEnumDebugStreams::get_Count method.
stream
[out] Returns an IDiaEnumDebugStreamData object representing the specified debug stream.
Return Value
If successful, returns S_OK; otherwise, returns an error code.
Example
IDiaEnumDebugStreamData *GetStreamData(IDiaEnumDebugStreams *pStreamList,
LONG whichStream)
{
IDiaEnumDebugStreamData *pStreamData = NULL;
if (pStreamList != NULL)
{
LONG numStreams = 0;
if (pStreamList->get_count(&numStreams) == S_OK &&
whichStream >= 0 && whichStream < numStreams)
{
VARIANT vIndex;
vIndex.vt = VT_I4;
vIndex.lVal = whichStream;
if (pStreamList->Item(vIndex,&pStreamData) != S_OK)
{
std::cerr << "Error retrieving stream " << whichStream << std::endl;
}
}
}
return(pStreamData);
}