IJolietDiscMaster::SetJolietProperties method (imapi.h)

Article
02/22/2024

Sets the Joliet properties.

Syntax

HRESULT SetJolietProperties(
  [in] IPropertyStorage *pPropStg
);

Parameters

[in] pPropStg

Pointer to the IPropertyStorage interface that the Joliet interface can use to retrieve new settings on various properties.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Remarks

Applications should query for a property set using GetJolietProperties, modify only those settings of interest, and then call SetJolietProperties to change all values simultaneously.

Some properties are read-only. Both read-only properties and unsupported properties are ignored without generating an error (see IMAPI_S_PROPERTIESIGNORED). For example, someone could submit a property set to this interface and attempt to change the ClearlyNeverHeardOfBefore property. Because ClearlyNeverHeardOfBefore is an unknown value, the property is ignored and the method succeeds.

After calling SetJolietProperties, an application should verify property settings by calling GetJolietProperties.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi.h
Library	Uuid.lib
DLL	Actxprxy.dll