Skip to content

Commit a70ae7a

Browse files
DennisLee-DennisLeeDennisLee-DennisLee
committed
Consolidated the ActivationFactory class.
1 parent b483b3c commit a70ae7a

8 files changed

Lines changed: 133 additions & 312 deletions

‎docs/windows/activationfactory-activationfactory-constructor.md‎

Lines changed: 0 additions & 33 deletions
This file was deleted.

‎docs/windows/activationfactory-addref-method.md‎

Lines changed: 0 additions & 40 deletions
This file was deleted.

‎docs/windows/activationfactory-class.md‎

Lines changed: 133 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: "ActivationFactory Class | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "11/04/2016"
4+
ms.date: "09/28/2018"
55
ms.technology: ["cpp-windows"]
66
ms.topic: "reference"
7-
f1_keywords: ["module/Microsoft::WRL::ActivationFactory"]
7+
f1_keywords: ["module/Microsoft::WRL::ActivationFactory", "module/Microsoft::WRL::ActivationFactory::ActivationFactory", "module/Microsoft::WRL::ActivationFactory::AddRef", "module/Microsoft::WRL::ActivationFactory::GetIids", "module/Microsoft::WRL::ActivationFactory::GetRuntimeClassName", "module/Microsoft::WRL::ActivationFactory::GetTrustLevel", "module/Microsoft::WRL::ActivationFactory::QueryInterface", "module/Microsoft::WRL::ActivationFactory::Release"]
88
dev_langs: ["C++"]
9-
helpviewer_keywords: ["ActivationFactory class"]
9+
helpviewer_keywords: ["Microsoft::WRL::ActivationFactory class", "Microsoft::WRL::ActivationFactory::ActivationFactory, constructor", "Microsoft::WRL::ActivationFactory::AddRef method", "Microsoft::WRL::ActivationFactory::GetIids method", "Microsoft::WRL::ActivationFactory::GetRuntimeClassName method", "Microsoft::WRL::ActivationFactory::GetTrustLevel method", "Microsoft::WRL::ActivationFactory::QueryInterface method", "Microsoft::WRL::ActivationFactory::Release method"]
1010
ms.assetid: 5faddf1f-43b6-4f8a-97de-8c9d3ae1e1ff
1111
author: "mikeblome"
1212
ms.author: "mblome"
@@ -40,7 +40,7 @@ The second interface.
4040
4141
## Remarks
4242
43-
**ActivationFactory** provides registration methods and basic functionality for the `IActivationFactory` interface. **ActivationFactory** also enables you to provide a custom factory implementation.
43+
`ActivationFactory` provides registration methods and basic functionality for the `IActivationFactory` interface. `ActivationFactory` also enables you to provide a custom factory implementation.
4444
4545
The following code fragment symbolically illustrates how to use ActivationFactory.
4646
@@ -54,20 +54,20 @@ The following code fragment shows how to use the [Implements](../windows/impleme
5454
5555
### Public Constructors
5656
57-
|Name|Description|
58-
|----------|-----------------|
59-
|[ActivationFactory::ActivationFactory Constructor](../windows/activationfactory-activationfactory-constructor.md)|Initializes the **ActivationFactory** class.|
57+
Name | Description
58+
---------------------------------------------------------- | ------------------------------------------
59+
[ActivationFactory::ActivationFactory](#activationfactory) | Initializes the `ActivationFactory` class.
6060
6161
### Public Methods
6262
63-
|Name|Description|
64-
|----------|-----------------|
65-
|[ActivationFactory::AddRef Method](../windows/activationfactory-addref-method.md)|Increments the reference count of the current **ActivationFactory** object.|
66-
|[ActivationFactory::GetIids Method](../windows/activationfactory-getiids-method.md)|Retrieves an array of implemented interface IDs.|
67-
|[ActivationFactory::GetRuntimeClassName Method](../windows/activationfactory-getruntimeclassname-method.md)|Gets the runtime class name of the object that the current **ActivationFactory** instantiates.|
68-
|[ActivationFactory::GetTrustLevel Method](../windows/activationfactory-gettrustlevel-method.md)|Gets the trust level of the object that the current **ActivationFactory** instantiates.|
69-
|[ActivationFactory::QueryInterface Method](../windows/activationfactory-queryinterface-method.md)|Retrieves a pointer to the specified interface.|
70-
|[ActivationFactory::Release Method](../windows/activationfactory-release-method.md)|Decrements the reference count of the current **ActivationFactory** object.|
63+
Name | Description
64+
-------------------------------------------------------------- | --------------------------------------------------------------------------------------------
65+
[ActivationFactory::AddRef](#addref) | Increments the reference count of the current `ActivationFactory` object.
66+
[ActivationFactory::GetIids](#getiids) | Retrieves an array of implemented interface IDs.
67+
[ActivationFactory::GetRuntimeClassName](#getruntimeclassname) | Gets the runtime class name of the object that the current `ActivationFactory` instantiates.
68+
[ActivationFactory::GetTrustLevel](#gettrustlevel) | Gets the trust level of the object that the current `ActivationFactory` instantiates.
69+
[ActivationFactory::QueryInterface](#queryinterface) | Retrieves a pointer to the specified interface.
70+
[ActivationFactory::Release](#release) | Decrements the reference count of the current `ActivationFactory` object.
7171
7272
## Inheritance Hierarchy
7373
@@ -97,6 +97,122 @@ The following code fragment shows how to use the [Implements](../windows/impleme
9797
9898
**Namespace:** Microsoft::WRL
9999
100-
## See Also
100+
## <a name="activationfactory"></a>ActivationFactory::ActivationFactory
101101
102-
[Microsoft::WRL Namespace](../windows/microsoft-wrl-namespace.md)
102+
Initializes the `ActivationFactory` class.
103+
104+
```cpp
105+
ActivationFactory();
106+
```
107+
108+
## <a name="addref"></a>ActivationFactory::AddRef
109+
110+
Increments the reference count of the current `ActivationFactory` object.
111+
112+
```cpp
113+
STDMETHOD_(
114+
ULONG,
115+
AddRef
116+
)();
117+
```
118+
119+
### Return Value
120+
121+
S_OK if successful; otherwise, an HRESULT that describes the failure.
122+
123+
## <a name="getiids"></a>ActivationFactory::GetIids
124+
125+
Retrieves an array of implemented interface IDs.
126+
127+
```cpp
128+
STDMETHOD(
129+
GetIids
130+
)(_Out_ ULONG *iidCount, _Deref_out_ _Deref_post_cap_(*iidCount) IID **iids);
131+
```
132+
133+
### Parameters
134+
135+
*iidCount*<br/>
136+
When this operation completes, the number of interace IDs in the *iids* array.
137+
138+
*iids*<br/>
139+
When this operation completes, an array of implemented interface IDs.
140+
141+
### Return Value
142+
143+
S_OK if successful; otherwise, an HRESULT that describes the failure. E_OUTOFMEMORY is a possible failure HRESULT.
144+
145+
## <a name="getruntimeclassname"></a>ActivationFactory::GetRuntimeClassName
146+
147+
Gets the runtime class name of the object that the current `ActivationFactory` instantiates.
148+
149+
```cpp
150+
STDMETHOD(
151+
GetRuntimeClassName
152+
)(_Out_ HSTRING* runtimeName);
153+
```
154+
155+
### Parameters
156+
157+
*runtimeName*<br/>
158+
When this operation completes, a handle to a string that contains the runtime class name of the object that the current `ActivationFactory` instantiates.
159+
160+
### Return Value
161+
162+
S_OK if successful; otherwise, an HRESULT that describes the failure.
163+
164+
## <a name="gettrustlevel"></a>ActivationFactory::GetTrustLevel
165+
166+
Gets the trust level of the object that the current `ActivationFactory` instantiates.
167+
168+
```cpp
169+
STDMETHOD(
170+
GetTrustLevel
171+
)(_Out_ TrustLevel* trustLvl);
172+
```
173+
174+
### Parameters
175+
176+
*trustLvl*<br/>
177+
When this operation completes, the trust level of the runtime class that the `ActivationFactory` instantiates.
178+
179+
### Return Value
180+
181+
S_OK if successful; otherwise, an assertion error is emitted and *trustLvl* is set to `FullTrust`.
182+
183+
## <a name="queryinterface"></a>ActivationFactory::QueryInterface
184+
185+
Retrieves a pointer to the specified interface.
186+
187+
```cpp
188+
STDMETHOD(
189+
QueryInterface
190+
)(REFIID riid, _Deref_out_ void **ppvObject);
191+
```
192+
193+
### Parameters
194+
195+
*riid*<br/>
196+
An interface ID.
197+
198+
*ppvObject*<br/>
199+
When this operation is complete, a pointer to the interface specified by parameter *riid*.
200+
201+
### Return Value
202+
203+
S_OK if successful; otherwise, an HRESULT that describes the failure.
204+
205+
## <a name="release"></a>ActivationFactory::Release
206+
207+
Decrements the reference count of the current `ActivationFactory` object.
208+
209+
```cpp
210+
STDMETHOD_(
211+
ULONG,
212+
Release
213+
)();
214+
```
215+
216+
### Return Value
217+
218+
S_OK if successful; otherwise, an HRESULT that describes the failure.

‎docs/windows/activationfactory-getiids-method.md‎

Lines changed: 0 additions & 47 deletions
This file was deleted.

‎docs/windows/activationfactory-getruntimeclassname-method.md‎

Lines changed: 0 additions & 44 deletions
This file was deleted.

0 commit comments

Comments
 (0)