Document revision date: 28 June 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]


Previous

17.2 RPC_WINNT_FREE_AUTH_IDENTITY


NAME       
 
        rpc_winnt_free_auth_identity - This function is called by the client 
        RPC application to free a a WINNT auth_identity structure that was 
        previously allocated by a call to rpc_winnt_set_auth_identity(). 
 
SYNOPSIS 
 
        #include <rpc.h> 
 
        PUBLIC void rpc_winnt_free_auth_identity ( 
                rpc_auth_identity_handle_t  *auth_identity, 
                unsigned32                        *stp) 
 
PRAMETERS 
 
        INPUT 
                auth_identity - Pointer to a pointer to WINNT auth_identity structure. 
                                On output auth_identity will be set to NULL. 
        OUTPUT 
                stp             Pointer to returned status. 
 

18 New APIs for Impersonation in DCE Version 1.5

The following APIs are included in DCE Version 1.5 to support server impersonation of a client. This means that the server runs with the security credentials of the client, and all of the capabilities of the client belong to the server.

18.1 RPC_IMPERSONATE_CLIENT


NAME 
 
        rpc_impersonate_client - This function is called by the server 
        application to allow the current server thread to run with all 
        of the client privileges. 
 
SYNOPSIS 
        
        #include <rpc.h> 
 
        void rpc_impersonate_client( 
                rpc_binding_handle_t binding_handle, 
                rpc_status_t *status) 
 
PARAMETERS 
 
        INPUT 
                binding_handle - Specifies a server-side call handle for this 
                RPC which represents the client to impersonate. 
 
        OUTPUT 
                status - Specifies a pointer to an unsigned 32 bit integer 
                that holds a status code. 

18.2 RPC_REVERT_TO_SELF


NAME 
 
        rpc_revert_to_self -  This function is called by the server application 
        to revert back to its original security context after impersonating a client. 
 
SYNOPSIS 
        
        #include <rpc.h> 
 
        rpc_revert_to_self(*status)                
 
PARAMETERS 
 
        INPUT 
                NONE 
        OUTPUT 
                status - Specifies a pointer to an unsigned 32 bit integer 
                that holds a status code. 

18.3 RPC_REVERT_TO_SELF_EX


NAME 
 
        rpc_revert_to_self_ex - This function is called by the server 
        application to revert back to its original security context after 
        impersonating a client.  This acts as a call to rpc_revert_to_self(); 
 
SYNOPSIS 
        
        #include <rpc.h> 
 
        rpc_revert_to_self_ex( 
                rpc_binding_handle_t        binding_handle, 
                rpc_status_t                *status) 
 
PARAMETERS 
 
        INPUT 
                call handle - This parameter is ignored. 
        OUTPUT 
                status - Specifies a pointer to an unsigned 32 bit integer 
                that holds a status code. 

18.4 Enhanced RPC Security APIs

For more information on existing enhanced RPC security APIs, see the Digital DCE for OpenVMS VAX and OpenVMS Alpha Reference Guide.

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
DCE_RELNOTES_003.HTML