IDVBCMClient::usercan

Method Signatures

C\C++

HRESULT UserCan(

DVBCMCONFIGUREDACTION dvbcmConfiguredAction,

long lAreaID,

BSTR bstrConfirmerName,

BSTR bstrConfirmerPassword,

BSTR bstrVerifierName,

BSTR bstrVerifierPassword,

VARIANT_BOOL *bUserCan)

VB

Public Function UserCan(

DVBCMCONFIGUREDACTION dvbcmConfiguredAction,

long lAreaID,

BSTR bstrConfirmerName,

BSTR bstrConfirmerPassword,

BSTR bstrVerifierName,

BSTR bstrVerifierPassword) As Boolean

This method determines if the provided confirmer/verifier pair has the rights to perform the requested action. First, this method verifies the password information via the Windows security protocols; second, it determines if the specified user has the required DeltaV rights. The check is area specific, thus the area ID argument, which must be a valid area resource ID.

Return Values

S_OK - success

else - failed

Memory Allocation

None

Parameter Name

Purpose

dvbcmConfiguredAction

Configured action enumeration, refer to the GetConfiguredAction topic for list of available actions.

lAreaID

Valid Equipment ID for the area on which the rights check will be performed. This information is returned via either the IDVBCMExecInfo2::GetExecutiveUnitInfo2 or IDVBCMRecipeEdit/Info::GetUnitBindings methods.

bstrConfirmerName

DeltaV username on which to check rights.

bstrConfirmerPassword

Windows username password for the supplied username.

bstrVerifierName

If the action requires verification, the name of the user providing the verification.

bstrVerifierPassword

Windows username password for the supplied verifier.

bUserCan

Boolean result of call, True if the user can perform the action.