IAzApplication::SetProperty method (azroles.h)

Article
02/22/2024

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

Share via