Chat now with support
Chat with Support

InTrust 11.6.1 - InTrust SDK Reference

InTrust SDK Overview Repository Services API Log Knowledge Base API Enumerations Interfaces

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.

NOTE: There is no setter method for the name of a property. Instead of renaming an existing property, you need to create a new one in the property collection (IPropertyCollection) and assign it the value you need. The old property can be deleted using the collection's Remove method.

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

IProperty**

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.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating