IDiaEnumDebugStreams::Item

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);
}

See also

• IDiaEnumDebugStreamData
• IDiaEnumDebugStreams