The client specifies how the server impersonates the client when the client establishes the string binding. This QOS information is provided as an endpoint option in the string binding. The client can specify the level of impersonation, dynamic or static tracking, and the effective-only flag.
To supply quality-of-service information for the server
- The client calls RpcStringBindingCompose to create the component strings, including endpoint options, in the correct string-binding context.
- The client calls RpcBindingFromStringBinding to obtain a new binding handle and to apply the quality-of-service information for the client.
- The client makes remote procedure calls using the handle.
Microsoft RPC supports Windows security features only on ncacn_np and ncalrpc. Security options for other transports are ignored.
The client can associate the following security parameters to the binding for the named-pipe transport ncacn_np or ncalrpc:
-
Identification, Impersonation, or Anonymous. Specifies the type of security used. The default is Impersonation.
-
Dynamic or Static. Determines whether security information associated with a thread is a copy of the security information created at the time the remote procedure call is made (static) or a pointer to the security information (dynamic).
Static security information does not change. The dynamic setting reflects the current security settings, including changes made after the remote procedure call is made. For ncacn_np, the default for remote named pipe connections is static, for local named pipe connections the default is dynamic.
-
TRUE or FALSE. Specifies the value of the effective-only flag. A value of TRUE indicates that only token privileges set to on at the time of the call are effective. A value of FALSE indicates that all privileges are available and that the application can modify them.
Any combination of these settings can be assigned to the binding, as shown in the following example:
"Security=Identification Dynamic True"
"Security=Anonymous Static True"
"Security=Impersonation Static False"
Default security-parameter settings vary according to the transport protocol.
For additional information about the syntax of the endpoint options, see endpoint.
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
