Global Functions

Topic Last Modified: 2006-06-11

The Exchange Application Security Module provides the following global functions.

Function Description Example

NumMasks()

Returns the number of masks defined in an entity object.

var n = NumMasks();

FAILED(nNum)

Determines if a call failed. Similar to the FAILED(hr) in C/C++.

If FAILED(objResult.number){ //error handling code }

SUCCEEDED(nNum)

Determines if a call succeeded. Similar to SUCCEEDED(hr) in C/C++.

If SUCCEEDED(objResult.number){ //error handling code }

objDacl DaclLegacyRoles()

Returns predefined permissions that represent the MAPI roles defined for a MAPI top-level hierarchy folder, as accessed by the Exchange System Manager.

var ObjDaclLRoles = DaclLegacyRoles();

// ObjDaclLRoles can now be used with some other DACL wherever a "template" is needed.

objDacl DaclLegacyMetaRights()

Similar to the DaclLegacyRoles function. Returns permissions such as "Can Create Subfolders."

var ObjDaclLMetaRights = DaclLegacyMetaRights();

// ObjDaclLMetaRights can now be used with some other DACL wherever a "template" is needed.

objDacl DaclWebStorageItem()

Returns permissions for an Exchange store item.

var ObjDaclWebStorageItem = DaclWebStorageItem();

// ObjDaclWebStorageItem can now be used with some other DACL wherever a "template" is needed.

objDacl DaclWebStorageFolder()

Returns permissions for an Exchange store folder.

var ObjDaclWebStorageFolder = DaclWebStorageFolder();

// ObjDaclWebStorageFolder can now be used with some other DACL wherever a "template" is needed.

objDacl DaclNTFile()

Returns the permissions for an item in the Microsoft® Windows® file system. These permissions are not used by the Application Security Module, but are available as a reference.

var ObjDaclNTFile = DaclNTFile();

// ObjDaclNTFile can now be used with some other DACL wherever a "template" is needed.

objDacl DaclNTFolder()

Returns the permissions for a folder in the Windows file system. These permissions are not used by the Application Security Module, but are available as a reference.

var ObjDaclNTFolder = DaclNTFolder();

// ObjDaclNTFolder can now be used with some other DACL wherever a "template" is needed.