IAzApplication::SetProperty method (azroles.h)

The SetProperty method sets the specified value to the IAzApplication object property with the specified property ID.

Syntax

HRESULT SetProperty(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

Parameters

[in] lPropId

Property ID of the IAzApplication object property to set. The following table shows the possible values.

Value Meaning
AZ_PROP_APPLICATION_DATA
Also accessed through the ApplicationData property
AZ_PROP_APPLICATION_AUTHZ_INTERFACE_CLSID
Also accessed through the AuthzInterfaceClsid property
AZ_PROP_APPLICATION_VERSION
Also accessed through the Version property
AZ_PROP_APPLY_STORE_SACL
Also accessed through the ApplyStoreSacl property
AZ_PROP_DESCRIPTION
Also accessed through the Description property
AZ_PROP_GENERATE_AUDITS
Also accessed through the GenerateAudits property
AZ_PROP_NAME
Also accessed through the Name property

[in] varProp

Value to set to the IAzApplication object property specified by the lPropId parameter. The type of data that must be used depends on the value of the lPropId parameter.

lPropId value Data type (C++/Visual Basic)
AZ_PROP_APPLICATION_DATA
BSTR/String
AZ_PROP_APPLICATION_INTERFACE_CLSID
BSTR/String
AZ_PROP_APPLICATION_VERSION
BSTR/String
AZ_PROP_APPLY_STORE_SACL
BSTR/String
AZ_PROP_DESCRIPTION
BSTR/String
AZ_PROP_GENERATE_AUDITS
BSTR/String
AZ_PROP_NAME
BSTR/String

[in, optional] varReserved

Reserved for future use.

Return value

If the method succeeds, the method returns S_OK.

Any other HRESULT value indicates that the operation failed.

Remarks

You must call the Submit method to persist any changes made by this method.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header azroles.h
Library Azroles.lib
DLL Azroles.dll
Redistributable Windows Server 2003 Administration Tools Pack on Windows XP