|
2 | 2 | title: "IDiaEnumSectionContribs | Microsoft Docs"
|
3 | 3 | ms.date: "11/04/2016"
|
4 | 4 | ms.topic: "conceptual"
|
5 |
| -dev_langs: |
| 5 | +dev_langs: |
6 | 6 | - "C++"
|
7 |
| -helpviewer_keywords: |
| 7 | +helpviewer_keywords: |
8 | 8 | - "IDiaEnumSectionContribs interface"
|
9 | 9 | ms.assetid: 0d6c0632-310f-4a99-8921-58149a1817e3
|
10 | 10 | author: "mikejo5000"
|
11 | 11 | ms.author: "mikejo"
|
12 | 12 | manager: jillfra
|
13 |
| -ms.workload: |
| 13 | +ms.workload: |
14 | 14 | - "multiple"
|
15 | 15 | ---
|
16 | 16 | # IDiaEnumSectionContribs
|
17 |
| -Enumerates the various section contributions contained in the data source. |
18 |
| - |
19 |
| -## Syntax |
20 |
| - |
21 |
| -``` |
22 |
| -IDiaEnumSectionContribs : IUnknown |
23 |
| -``` |
24 |
| - |
25 |
| -## Methods in Vtable Order |
26 |
| - The following table shows the methods of `IDiaEnumSectionContribs`. |
27 |
| - |
28 |
| -|Method|Description| |
29 |
| -|------------|-----------------| |
30 |
| -|[IDiaEnumSectionContribs::get__NewEnum](../../debugger/debug-interface-access/idiaenumsectioncontribs-get-newenum.md)|Retrieves the [IEnumVARIANT Interface](/previous-versions/windows/desktop/api/oaidl/nn-oaidl-ienumvariant) version of this enumerator.| |
31 |
| -|[IDiaEnumSectionContribs::get_Count](../../debugger/debug-interface-access/idiaenumsectioncontribs-get-count.md)|Retrieves the number of section contributions.| |
32 |
| -|[IDiaEnumSectionContribs::Item](../../debugger/debug-interface-access/idiaenumsectioncontribs-item.md)|Retrieves section contributions by means of an index.| |
33 |
| -|[IDiaEnumSectionContribs::Next](../../debugger/debug-interface-access/idiaenumsectioncontribs-next.md)|Retrieves a specified number of section contributions in the enumeration sequence.| |
34 |
| -|[IDiaEnumSectionContribs::Skip](../../debugger/debug-interface-access/idiaenumsectioncontribs-skip.md)|Skips a specified number of section contributions in an enumeration sequence.| |
35 |
| -|[IDiaEnumSectionContribs::Reset](../../debugger/debug-interface-access/idiaenumsectioncontribs-reset.md)|Resets an enumeration sequence to the beginning.| |
36 |
| -|[IDiaEnumSectionContribs::Clone](../../debugger/debug-interface-access/idiaenumsectioncontribs-clone.md)|Creates an enumerator that contains the same enumeration state as the current enumerator.| |
37 |
| - |
38 |
| -## Remarks |
39 |
| - |
40 |
| -## Note for Callers |
41 |
| - Obtain this interface from the [IDiaSession::getEnumTables](../../debugger/debug-interface-access/idiasession-getenumtables.md) method. See the example for details. |
42 |
| - |
43 |
| -## Example |
44 |
| - This example shows how to obtain (the `GetEnumSectionContribs` function) and use (the `ShowSectionContribs` function) the `IDiaEnumSectionContribs` interface. For a more complete example of using section contributions, see the [IDiaSectionContrib](../../debugger/debug-interface-access/idiasectioncontrib.md) interface. |
45 |
| - |
46 |
| -```C++ |
47 |
| - |
48 |
| - IDiaEnumSectionContribs* GetEnumSectionContribs(IDiaSession *pSession) |
49 |
| -{ |
50 |
| - IDiaEnumSectionContribs* pUnknown = NULL; |
51 |
| - REFIID iid = __uuidof(IDiaEnumSectionContribs); |
52 |
| - IDiaEnumTables* pEnumTables = NULL; |
53 |
| - IDiaTable* pTable = NULL; |
54 |
| - ULONG celt = 0; |
55 |
| - |
56 |
| - if (pSession->getEnumTables(&pEnumTables) != S_OK) |
57 |
| - { |
58 |
| - wprintf(L"ERROR - GetTable() getEnumTables\n"); |
59 |
| - return NULL; |
60 |
| - } |
61 |
| - while (pEnumTables->Next(1, &pTable, &celt) == S_OK && celt == 1) |
62 |
| - { |
63 |
| - // There is only one table that matches the given iid |
64 |
| - HRESULT hr = pTable->QueryInterface(iid, (void**)&pUnknown); |
65 |
| - pTable->Release(); |
66 |
| - if (hr == S_OK) |
67 |
| - { |
68 |
| - break; |
69 |
| - } |
70 |
| - } |
71 |
| - pEnumTables->Release(); |
72 |
| - return pUnknown; |
73 |
| -} |
74 |
| - |
75 |
| -void ShowSectionContribs(IDiaSession *pSession) |
76 |
| -{ |
77 |
| - IDiaEnumSectionContribs* pEnumSectionContribs; |
78 |
| - |
79 |
| - pEnumSectionContribs = GetEnumSectionContribs(pSession); |
80 |
| - if (pSectionContrib != NULL) |
81 |
| - { |
82 |
| - IDiaSectionContrib* pSectionContrib; |
83 |
| - ULONG celt = 0; |
84 |
| - |
85 |
| - while(pEnumSectionContribs->Next(1, &pSectionContrib, &celt) == S_OK && |
86 |
| - celt == 1) |
87 |
| - { |
88 |
| - PrintSectionContrib(pSectionContrib, pSession); |
89 |
| - pSectionContrib->Release(); |
90 |
| - } |
91 |
| - pSectionContrib->Release(); |
92 |
| - } |
93 |
| -} |
94 |
| -``` |
95 |
| - |
96 |
| -## Requirements |
97 |
| - Header: Dia2.h |
98 |
| - |
99 |
| - Library: diaguids.lib |
100 |
| - |
101 |
| - DLL: msdia80.dll |
102 |
| - |
103 |
| -## See Also |
104 |
| - [Interfaces (Debug Interface Access SDK)](../../debugger/debug-interface-access/interfaces-debug-interface-access-sdk.md) |
105 |
| - [IDiaSession::getEnumTables](../../debugger/debug-interface-access/idiasession-getenumtables.md) |
106 |
| - [IDiaSectionContrib](../../debugger/debug-interface-access/idiasectioncontrib.md) |
| 17 | +Enumerates the various section contributions contained in the data source. |
| 18 | + |
| 19 | +## Syntax |
| 20 | + |
| 21 | +``` |
| 22 | +IDiaEnumSectionContribs : IUnknown |
| 23 | +``` |
| 24 | + |
| 25 | +## Methods in Vtable Order |
| 26 | +The following table shows the methods of `IDiaEnumSectionContribs`. |
| 27 | + |
| 28 | +|Method|Description| |
| 29 | +|------------|-----------------| |
| 30 | +|[IDiaEnumSectionContribs::get__NewEnum](../../debugger/debug-interface-access/idiaenumsectioncontribs-get-newenum.md)|Retrieves the [IEnumVARIANT Interface](/previous-versions/windows/desktop/api/oaidl/nn-oaidl-ienumvariant) version of this enumerator.| |
| 31 | +|[IDiaEnumSectionContribs::get_Count](../../debugger/debug-interface-access/idiaenumsectioncontribs-get-count.md)|Retrieves the number of section contributions.| |
| 32 | +|[IDiaEnumSectionContribs::Item](../../debugger/debug-interface-access/idiaenumsectioncontribs-item.md)|Retrieves section contributions by means of an index.| |
| 33 | +|[IDiaEnumSectionContribs::Next](../../debugger/debug-interface-access/idiaenumsectioncontribs-next.md)|Retrieves a specified number of section contributions in the enumeration sequence.| |
| 34 | +|[IDiaEnumSectionContribs::Skip](../../debugger/debug-interface-access/idiaenumsectioncontribs-skip.md)|Skips a specified number of section contributions in an enumeration sequence.| |
| 35 | +|[IDiaEnumSectionContribs::Reset](../../debugger/debug-interface-access/idiaenumsectioncontribs-reset.md)|Resets an enumeration sequence to the beginning.| |
| 36 | +|[IDiaEnumSectionContribs::Clone](../../debugger/debug-interface-access/idiaenumsectioncontribs-clone.md)|Creates an enumerator that contains the same enumeration state as the current enumerator.| |
| 37 | + |
| 38 | +## Remarks |
| 39 | + |
| 40 | +## Note for Callers |
| 41 | +Obtain this interface from the [IDiaSession::getEnumTables](../../debugger/debug-interface-access/idiasession-getenumtables.md) method. See the example for details. |
| 42 | + |
| 43 | +## Example |
| 44 | +This example shows how to obtain (the `GetEnumSectionContribs` function) and use (the `ShowSectionContribs` function) the `IDiaEnumSectionContribs` interface. For a more complete example of using section contributions, see the [IDiaSectionContrib](../../debugger/debug-interface-access/idiasectioncontrib.md) interface. |
| 45 | + |
| 46 | +```C++ |
| 47 | + |
| 48 | +IDiaEnumSectionContribs* GetEnumSectionContribs(IDiaSession *pSession) |
| 49 | +{ |
| 50 | + IDiaEnumSectionContribs* pUnknown = NULL; |
| 51 | + REFIID iid = __uuidof(IDiaEnumSectionContribs); |
| 52 | + IDiaEnumTables* pEnumTables = NULL; |
| 53 | + IDiaTable* pTable = NULL; |
| 54 | + ULONG celt = 0; |
| 55 | + |
| 56 | + if (pSession->getEnumTables(&pEnumTables) != S_OK) |
| 57 | + { |
| 58 | + wprintf(L"ERROR - GetTable() getEnumTables\n"); |
| 59 | + return NULL; |
| 60 | + } |
| 61 | + while (pEnumTables->Next(1, &pTable, &celt) == S_OK && celt == 1) |
| 62 | + { |
| 63 | + // There is only one table that matches the given iid |
| 64 | + HRESULT hr = pTable->QueryInterface(iid, (void**)&pUnknown); |
| 65 | + pTable->Release(); |
| 66 | + if (hr == S_OK) |
| 67 | + { |
| 68 | + break; |
| 69 | + } |
| 70 | + } |
| 71 | + pEnumTables->Release(); |
| 72 | + return pUnknown; |
| 73 | +} |
| 74 | + |
| 75 | +void ShowSectionContribs(IDiaSession *pSession) |
| 76 | +{ |
| 77 | + IDiaEnumSectionContribs* pEnumSectionContribs; |
| 78 | + |
| 79 | + pEnumSectionContribs = GetEnumSectionContribs(pSession); |
| 80 | + if (pSectionContrib != NULL) |
| 81 | + { |
| 82 | + IDiaSectionContrib* pSectionContrib; |
| 83 | + ULONG celt = 0; |
| 84 | + |
| 85 | + while(pEnumSectionContribs->Next(1, &pSectionContrib, &celt) == S_OK && |
| 86 | + celt == 1) |
| 87 | + { |
| 88 | + PrintSectionContrib(pSectionContrib, pSession); |
| 89 | + pSectionContrib->Release(); |
| 90 | + } |
| 91 | + pSectionContrib->Release(); |
| 92 | + } |
| 93 | +} |
| 94 | +``` |
| 95 | +
|
| 96 | +## Requirements |
| 97 | +Header: Dia2.h |
| 98 | +
|
| 99 | +Library: diaguids.lib |
| 100 | +
|
| 101 | +DLL: msdia80.dll |
| 102 | +
|
| 103 | +## See Also |
| 104 | +[Interfaces (Debug Interface Access SDK)](../../debugger/debug-interface-access/interfaces-debug-interface-access-sdk.md) |
| 105 | +[IDiaSession::getEnumTables](../../debugger/debug-interface-access/idiasession-getenumtables.md) |
| 106 | +[IDiaSectionContrib](../../debugger/debug-interface-access/idiasectioncontrib.md) |
0 commit comments