IObserver
Provides a mechanism for receiving push-based notifications. You need to create your own implementation of this interface.
Methods
OnDone
Notifies the observer that the provider has finished sending push-based notifications.
Syntax
void OnDone();
OnError
Notifies the observer that the provider has experienced an error condition.
Syntax
void OnError(
[in] HRESULT hr,
[in] BSTR description
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
hr |
HRESULT |
Operation result. |
|
description |
BSTR |
Additional information about the error. |
OnNext
Provides the observer with new data.
Syntax
void OnNext(
[in] IUnknown* data
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
data |
IUnknown* |
The current notification information. |
IOrganizationalUnitSiteObject
Represents an organizational unit from which to put computers in an InTrust site.
Methods
CanonicalName (getter)
Returns the canonical name of the organizational unit.
Syntax
HRESULT CanonicalName(
[out, retval]BSTR* bstrCanonicalName
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrCanonicalName |
BSTR* |
Canonical name of the organizational unit. |
CanonicalName (setter)
Sets the canonical name of the organizational unit.
Syntax
HRESULT CanonicalName(
[in]BSTR bstrCanonicalName
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrCanonicalName |
BSTR |
Canonical name of the organizational unit. |
DistinguishedName (getter)
Returns the distinguished name of the organizational unit.
Syntax
HRESULT DistinguishedName(
[out, retval]BSTR* bstrDistinguishedName
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrDistinguishedName |
BSTR* |
Distinguished name of the organizational unit. |
DistinguishedName (setter)
Sets the distinguished name of the organizational unit.
Syntax
HRESULT DistinguishedName(
[in]BSTR bstrDistinguishedName
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrDistinguishedName |
BSTR |
Distinguished name of the organizational unit. |
Domain (getter)
Returns the domain of the organizational unit.
Syntax
HRESULT Domain(
[out, retval]BSTR* bstrDomain
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrDomain |
BSTR* |
Domain of the organizational unit. |
Domain (setter)
Sets the domain of the organizational unit.
Syntax
HRESULT Domain(
[in]BSTR bstrDomain
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrDomain |
BSTR |
Domain of the organizational unit. |
IProperty
Represents a property attached to an InTrust repository. A property is a way to tag repositories for arbitrary purposes.
Methods
PropertyName (setter)
Sets the name of the property.
Syntax
HRESULT PropertyName(
[in] BSTR pVal
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
pVal |
BSTR |
Name of the property. The name must be unique in the property collection (see IPropertyCollection). |
PropertyValue (getter)
Returns the value of the property.
Syntax
HRESULT PropertyValue(
[out, retval] VARIANT *pVal
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
pVal |
VARIANT* |
Value of the property. |
PropertyValue (setter)
Sets the value of the property.
Syntax
HRESULT PropertyValue(
[in] VARIANT pVal
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
pVal |
VARIANT |
Value of the property. |
PropertyName
Returns the name of the property.
|
|
|
Syntax
HRESULT PropertyName(
[out, retval] BSTR *pVal
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
pVal |
BSTR* |
Name of the property. |
IPropertyCollection
Represents a collection of properties associated with an InTrust repository. Access to the collections is gained through specialized methods of the IInTrustRepository3 interface (such as CustomAttributes and ForwardingProperties), which filter the available properties by purpose.
Methods
Item
Gets a property from the collection by name.
Syntax
HRESULT Item(
[in] BSTR bstrPropertyName,
[out, retval] IProperty** ppProperty
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
bstrPropertyName |
BSTR |
Name of the property. This name must exist in the collection. |
| ppProperty |
The property. |
_NewEnum
Returns an enumerator for the collection.
Syntax
HRESULT _NewEnum(
[out, retval] LPUNKNOWN* pVal
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
pVal |
LPUNKNOWN* |
Collection enumerator. |
Set
Sets the specified property if it exists or creates it if it doesn't.
Syntax
HRESULT Set(
[in] BSTR bstrPropertyName,
[in] VARIANT varPropertyValue
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
bstrPropertyName |
BSTR |
Name of the property to add. The name must be unique. |
| varPropertyValue | BSTR |
The value to set. |
Remove
Removes a property from the collection by name.
Syntax
HRESULT Remove(
[in] BSTR bstrPropertyName
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
bstrPropertyName |
BSTR |
Name of the property to remove. |