Esempio di BIND

Nell'esempio seguente viene illustrato il controllo dell'immagine BIND in ingresso usando queste funzionalità di SLI_OPEN.

lua_vcb.specific.open.lua_open_extension[0].lua_routine_type  =    
    LUA_ROUTINE_TYPE_BIND;  
strcpy(lua_vcb.specific.open.lua_open_extension[0].lua_module_name,   
    "WINSLI32");  
strcpy(lua_vcb.specific.open.lua_open_extension[0].lua_procedure_name,  
    "BindValidation");  
lua_vcb.specific.open.lua_open_extension[1].lua_routine_type =   
     LUA_ROUTINE_TYPE_END;  
  

Si noti che per Microsoft Visual C++ 4.0 o versione successiva e per Windows Server, il prototipo di funzione deve essere:

VOID WINAPI BindValidation (LUA_VERB_RECORD FAR * pVerb );  
  

In Windows Server la macro WINAPI equivale a _STDCall.

La routine BIND ha accesso al blocco di controllo verbo (LUA) dell'applicazione logica (LUA) passato. La routine BIND deve convalidare BIND e indicare il codice primario e secondario di Session Level Interface (SLI) appropriato nel record verbo LUA. Inoltre, la routine può indicare le dimensioni dell'unità richiesta/risposta primaria e secondaria supportate dal programma SLI impostando byte 10 e 11 nel campo common.lua_data_ptr (dove è indicato il comando BIND).

Di seguito sono riportate le opzioni del compilatore Visual C++ per il modulo contenente il callback:

/FA -c -Zle -W3 -WX -Ge -Gy -Gz -Ox -Zd  
-DCONDITION_HANDLING -DSTD_CALL  
-Di386=1 -D_X86_ -DNT_UP -DWIN32 -DDEVL  
-D_DLL -D_MT  -DWIN32_SUPPORT  
  

Di seguito è riportato il codice generato per il callback:

PUBLIC _BindValidation@4  
; COMDAT _BindValidation@4  
_TEXT SEGMENT  
   _pVerb$ = 8  
   _BindValidation@4 PROC NEAR    ; COMDAT  
  
   // pVerb->common.lua_prim_rc = LUA_STATE_CHECK;  
   mov eax, DWORD PTR _pVerb$[esp-4]  
   mov WORD PTR [eax+4], 512   ; 00000200H  
   ret 4  
_BindValidation@4 ENDP  
_TEXT ENDS  

Di seguito è riportato il codice generato da SLI per chiamare questo callback:

// (*aSCB->bind_rtn)(sliVCB);  
push    ebp  
call    DWORD PTR [ebx+188]  
// note there is no ADD ESP,4 following the call  

Di seguito è riportata la traccia interna del client che mostra WINSLI che rileva il callback di convalida di associazione fornito dall'utente:

|00000157.000000f7 OUDMD  Opening User DLL Modules  
|00000157.000000f7 OUDMD  Opening a Bind Routine  
|00000157.000000f7 OUDMD  Opening DLL = WINSLI32  
|00000157.000000f7 OUDMD  Loading Routine = BindValidation  

Di seguito è riportata la traccia interna client che mostra il callback di convalida di associazione:

|00000157.0000015c CLUAD  Calling BIND Routine  
|00000157.0000015c CLUAD  Return from BIND routine, prc=512  
|00000157.0000015c CLUAD  Returned With Error From Routine  
|00000157.0000015c FrRUI  Freeing RUI vcb = 0x14E424  
|00000157.0000015c BINDP  USER BIND ROUTINE FAILED  

Di seguito è riportata una traccia API per visualizzare l'errore di convalida del binding:

000015c SLI    ----------------------------------------------   11:11:52.28  
000015c SLI    SLI_OPEN post  
000015c SLI    SESSION_FAILURE - NEG_RSP_FROM_BIND_ROUTINE  
000015c SLI    ---- Verb Parameter Block at address 00405150 ----  
000015c SLI    52004900 000F0000 00000039 01000000        
    <R.I........9....>  
000015c SLI    00000000 4C553220 20202020 48000000         
    <....LU2     H...>  
000015c SLI    88E01400 00000400 C0904000 F4000000         
    <h.........@.4...>  
000015c SLI    00000000 00000000 00000040 00000000         
    <...........@....>  
000015c SLI    00000000 02000000 0157494E 534C4933         
    <.........WINSLI3>  
000015c SLI    32004269 6E645661 6C696461 74696F6E         
    <2.BindValidation>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 00000000 00000000         
    <................>  
000015c SLI    00000000 00000000 0000                      
    <..........      >  
000015c SLI    ---- Data at address 004090C0 ----  
000015c SLI    86998584                                    
    <fred            >