MetaUserInfo Class
The IMetaUserInfo interface is used to create, update, read or delete a CMetaUser class. See Chapter 13: “Security Classes” for more detailed information.
Property |
Type |
Description |
Common Properties |
|
Common Properties
Delete
Purpose:
Use this method to delete the user object from the MDS repository.
Requirements:
The object identifier must be set before calling the Delete method.
Syntax:
HRESULT Delete();
Read
Purpose:
Use this method to read the user object from the MDS repository.
Requirements:
The object identifier must be set before calling the Read method.
Syntax:
HRESULT Read();
Write
Purpose:
Use this method to update or write the user object to the MDS repository.
Requirements:
The object identifier must be set before calling the Write method
Syntax:
HRESULT Write();
IsSuperUser
Purpose:
Returns VARIANT_TRUE of VARIANT_VALSE (true or false) depending on whether the caller is an MDS "super user" or "MDS administrator").
Syntax:
HRESULT IsSuperUser(
[out, retval] VARIANT_BOOL *pVal);
CreateSuperUser
Purpose:
Use this method to create an MDS administrator, also known as a super user.
Description:
This method is identical in effect to “Write” except that the user created is a “super user” (or “administrator”) - and has all the same privileges as the “metasu” built-in super user. The Description may be empty.
Syntax:
HRESULT CreateSuperUser(
[in] BSTR Name,
[in] BSTR Password,
[in, optional] BSTR Description);
ChangePassword
Purpose:
Use this method to change the user password.
Description:
If the logged-on user is an MDS Administrator, the OldPassword parameter value is not required and can be NULL.
Syntax:
HRESULT ChangePassword(
[in] BSTR OldPassword,
[in] BSTR NewPassword);