IFaxSecurity::get_InformationType method (faxcomex.h)

The IFaxSecurity::InformationType property represents the security information type.

This property is read/write.

Syntax

HRESULT get_InformationType(
  long *plInformationType
);

Parameters

plInformationType

Return value

None

Remarks

The information type is a bitwise combination that indicates what security information will be retrieved from the server when requesting a security descriptor using the IFaxSecurity::Descriptor property or when refreshing the IFaxSecurity object using the IFaxSecurity::Refresh method. The information type also determines what information is sent to the fax server when you save changes to the IFaxSecurity object using the IFaxSecurity::Save method.

The bits are specified in the SECURITY_INFORMATION structure, defined in Winnt.h. Each item of security information is designated by a bit flag. The following values specify the bits applicable to the fax service.

Value	Meaning
DACL_SECURITY_INFORMATION	Indicates that the discretionary access control list (ACL) of the object is being referenced.
GROUP_SECURITY_INFORMATION	Indicates that the primary group identifier of the object is being referenced.
OWNER_SECURITY_INFORMATION	Indicates that the owner identifier of the object is being referenced.
SACL_SECURITY_INFORMATION	Indicates that the system ACL of the object is being referenced.

 

You should set the IFaxSecurity::InformationType property before you call the IFaxSecurity::get_Descriptor method to ensure that you receive the information that you want and to ensure that you request only the information for which you have the appropriate access rights. Also, the IFaxSecurity::InformationType property will affect what information is sent to the fax server when you call the IFaxSecurity::Save method. If you do not set the IFaxSecurity::InformationType property, it defaults to the flags DACL_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, and OWNER_SECURITY_INFORMATION.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	faxcomex.h
DLL	Fxscomex.dll