View source for RPC HELP TVistaLogin Mode Example

<h2>Silent Login Examples</h2>

<h3>Example 1: lmAVCodes</h3>
	
Here is an example of how to use Silent Login by passing the Access and Verify codes to the [[RPC_HELP_TVistaLogin|TVistaLogin]] class.


    brkrRPCBroker1.KernelLogIn := False;
    brkrRPCBroker1.LogIn.Mode := lmAVCodes;
    brkrRPCBroker1.LogIn.AccessCode := ********;
    brkrRPCBroker1.LogIn.VerifyCodeCode := ********;
    brkrRPCBroker1.LogIn.PromptDivison := True;
    brkrRPCBroker1.LogIn.OnFailedLogin := myevent;
    '''try'''
      brkrRPCBroker1.Connected := True;
    '''except
      exit
    end;'''
	

If brkrRPCBroker1.Connected is True, then Silent Login has worked.
	
NOTE: For a demonstration using the lmAVCodes, please run the lmAVCodes_Demo.EXE located in the ..\BDK32\Samples\SilentSignOn directory.
	

<h3>Example 2: lmAppHandle</h3>

Here is an example of how to use Silent Login by passing an Application Handle to the [[RPC_HELP_TVistaLogin|TVistaLogin]] class.

The lmAppHandle mode of the Silent Login is used when an application starts up a second application. If the second application tests for arguments on the command line, it is possible for this application to be started and make a connection to the VistA M Server without user interaction.

An example of a procedure for starting a second application with data on the command line to permit a Silent Login using the LoginHandle provided by the first application is shown below. This is followed by a procedure that can be called in the processing related to FormCreate to use this command line data to initialize the TRPCBroker component for Silent Login.
	
'''NOTE: It should be noted that the procedures shown here are included within the RpcSLogin unit, and can be used directly from there.'''

If the value for ConnectedBroker is nil, the application specified in ProgLine will be started and any command line included in ProgLine will be passed to the application.

In the second application, a call to the Broker should be made shortly after starting, since the LoginHandle passed in has a finite lifetime (approximately 20 seconds) during which it is valid for the Silent Login.
	

    '''procedure''' StartProgSLogin(const ProgLine: String; ConnectedBroker: TRPCBroker);
    '''var'''
      StartupInfo: TStartupInfo;
      ProcessInfo: TProcessInformation;
      AppHandle: String;
      CmndLine: String;
    '''begin'''
      FillChar(StartupInfo, SizeOf(TStartupInfo), 0);
      '''with''' StartupInfo '''do begin'''
        cb := SizeOf(TStartupInfo);
        dwFlags := STARTF_USESHOWWINDOW;
        wShowWindow := SW_SHOWNORMAL;
      '''end;'''
      CmndLine := ProgLine;
      '''if''' ConnectedBroker <> nil '''then begin'''
        AppHandle := GetAppHandle(ConnectedBroker);
        CmndLine := CmndLine + ' s='+ConnectedBroker.Server + ' p='
        + IntToStr(ConnectedBroker.ListenerPort) + ' h='
        + AppHandle + ' d=' + ConnectedBroker.User.Division;
      '''end;'''
      CreateProcess(nil, Pchar(CmndLine), nil, nil, False,
      NORMAL_PRIORITY_CLASS, nil, nil, StartupInfo, ProcessInfo);
    '''end;'''


    {btnStart is clicked to start the second application Test2.exe}
    '''procedure''' TForm1.btnStartClick(Sender: TObject);
    var
      CurDir: string;
    '''begin'''
      {Use Test2.exe and expecting it to be in the startup directory for the current application}
      CurDir := ExtractFilePath(ParamStr(0)) + 'Test2.exe';
      {Now start application with Silent Login}
      StartProgSLogin(CurDir, brkrRPCB1);
    '''end;'''


The following procedure (CheckCmdLine) would be called in the FormCreate code of the application being started to check for command line input, and if relevant to the Broker connection, to set it up.

This code assumes that s=, p=, d=, and h= are used in conjunction with the values for Server, ListenerPort, User.Division, and LoginHandle, respectively.

The command line might look like:

    ProgramName.exe s=DHCPSERVER p=9200 d=692 h=~1XM34XYYZZQQ_X
	

The [[RPC_HELP_TRPCB|TRPCB]]  and RpcSLogin units would need to be included in the USES clause.


    procedure CheckCmdLine(brkrRPCB: TRPCBroker);
    var
      j: integer;
    begin
      // Iterate through possible command line arguments
      for j := 0 to 15 do begin
        if ParamStr(j) <> '' then
          Form1.Memo1.Lines.Add(IntToStr(j) + ' ' + ParamStr(j));
        if Pos('p=',ParamStr(j)) > 0 then
          brkrRPCB.ListenerPort := StrToInt(Copy(ParamStr(j),(Pos('=',ParamStr(j))+1),length(ParamStr(j))));
        if Pos('s=',ParamStr(j)) > 0 then
          brkrRPCB.Server := Copy(ParamStr(j),(Pos('=',ParamStr(j))+1),length(ParamStr(j)));
        if Pos('h=',ParamStr(j)) > 0 then begin
          brkrRPCB.Login.LoginHandle := Copy(ParamStr(j),(Pos('=',ParamStr(j))+1),length(ParamStr(j)));
          if brkrRPCB.Login.LoginHandle <> '' then begin
            brkrRPCB.KernelLogIn := False;
            brkrRPCB.Login.Mode := lmAppHandle;
          end;
        end;
        if Pos('d=',ParamStr(j)) > 0 then
          brkrRPCB.Login.Division := Copy(ParamStr(j),(Pos('=',ParamStr(j))+1),length(ParamStr(j)));
      // for end
      end;
    end;
	
For a demonstration using the lmAppHandle, please run the lmAppHandle_Demo.EXE located in the ..\BDK32\Samples\SilentSignOn directory.