FaxSecurity2.InformationType property

Retrieves the security information type.

This property is read/write.

Syntax

Property InformationType As Long

Property value

A Long that specifies or receives the security information type.

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 Descriptor property, or when refreshing the FaxSecurity2 object using the Refresh method. The information type property also determines what information is sent to the fax server when you save changes to the FaxSecurity2 object using the 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.

 

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

Requirements

Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
FaxComex.h
DLL
Fxscomex.dll

See also

FaxSecurity2

IFaxSecurity2