Sub ChangeState2( _
   ByVal lParentWnd As System.Integer, _
   ByVal bsPasswd As System.String, _
   Optional ByVal poCallback As EdmCallback _
) 

void ChangeState2( 
   System.int lParentWnd,
   System.string bsPasswd,
   EdmCallback poCallback
)

void ChangeState2( 
&   System.int lParentWnd,
&   System.String^ bsPasswd,
&   EdmCallback^ poCallback
) 

Parameters

lParentWnd

Parent window handle that is passed to add-ins that are notified about file state changes in the vault

bsPasswd

Password of user executing the transition

poCallback

Optional pointer to a class that implements IEdmCallback to receive progress information about the operation

The difference between this method and the now obsolete IEdmBatchChangeState::ChangeState is that this method specifies a user password that allows the file to change state if the transition requires authentication (IEdmTransition10::Authentication).

Before calling this method, you must call IEdmBatchChangeState::CreateTree if changing states or IEdmBatchChangeState2::CreateTreeForRevoke if revoking transitions.

Return codes:

• E_EDM_STATECHANGE_FAILED: The password is invalid.
• S_OK: The method successfully executed.
• S_FALSE: One of the arguments is invalid.