srv_impersonate_client

Impersonates the security context of a client connection.

Syntax

int srv_impersonate_client ( SRV_PROC * srvproc );

Arguments

srvproc

Is a pointer to the SRV_PROC structure that is the handle for a particular client connection. The srvproc parameter contains information the ODS 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 by 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 Microsoft® Windows NT® security measures.
• The Open Data Services application does not need to maintain a separate security system.
• The network administrator only needs to be concerned about security 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 Multiprotocol Net-Libraries.

See Also