srv_impersonate_client

Impersonates the security context of a client connection.

Syntax

int srv_impersonate_client ( SRV_PROC * srvproc );

where

srvproc

Is a pointer to the SRV_PROC structure that is the handle for a particular client connection. The srvproc parameter contains the information that the Open Data Services Library uses to manage communication and data between the application and the client.

Returns

SUCCEED if the security context of the client connection was impersonated; otherwise, FAIL.

Remarks

After calling srv_impersonate_client, the Open Data Services application can perform operations on a client's behalf, using the security context of the client connection. This is called "pass-through" security. To stop impersonating the client connection, call srv_revert_to_self.

Using srv_impersonate_client for "pass-through" security simplifies the setup and administration of security procedures because:

• The Open Data Services application can rely on existing Windows NT security measures.
• The Open Data Services application does not need to maintain a separate security system.
• The network administrator needs to be concerned about security only between the Open Data Services client and the resource the Open Data Services application is using on that client's behalf.

The srv_impersonate_client function currently supports impersonating client connections that use the named pipes or multi-protocol Net-Library.

See Also