IFaxSecurity2::put_InformationType method (faxcomex.h)
Retrieves the security information type.
This property is read/write.
Syntax
HRESULT put_InformationType(
long lInformationType
);
Parameters
lInformationType
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 Descriptor property, or when refreshing the FaxSecurity2 object using the IFaxSecurity2::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 IFaxSecurity2::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 IFaxSecurity2::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 IFaxSecurity2::InformationType property will affect what information is sent to the fax server when you call the IFaxSecurity2::Save method. If you do not set the IFaxSecurity2::InformationType property, it defaults to the flags DACL_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, and OWNER_SECURITY_INFORMATION.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | faxcomex.h |
| DLL | Fxscomex.dll |