UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:rpcdce.RpcBindingInqAuthClientEx |
RpcBindingInqAuthClientEx function (rpcdce.h) |
The RpcBindingInqAuthClientEx function (rpcdce.h) obtains extended information about the client program that made the remote procedure call. |
|
rpc\rpcbindinginqauthclientex.htm |
Rpc |
4ee73a2b-8722-44f0-af0d-dedcb27ba224 |
08/16/2022 |
RPC_C_FULL_CERT_CHAIN, RpcBindingInqAuthClientEx, RpcBindingInqAuthClientEx function [RPC], RpcBindingInqAuthClientExA, RpcBindingInqAuthClientExW, _rpc_rpcbindinginqauthclientex, rpc.rpcbindinginqauthclientex, rpcdce/RpcBindingInqAuthClientEx, rpcdce/RpcBindingInqAuthClientExA, rpcdce/RpcBindingInqAuthClientExW |
rpcdce.h |
Rpc.h |
Windows |
Windows 2000 Professional [desktop apps only] |
Windows 2000 Server [desktop apps only] |
RpcBindingInqAuthClientExW (Unicode) and RpcBindingInqAuthClientExA (ANSI) |
Rpcrt4.lib |
Rpcrt4.dll |
Windows |
19H1 |
|
|
|
|
|
|
A server application calls the RpcBindingInqAuthClientEx function to obtain extended information about the client program that made the remote procedure call.
Client binding handle of the client that made the remote procedure call. This value can be zero. See Remarks.
Returns a pointer to a handle to the privileged information for the client application that made the remote procedure call on the ClientBinding binding handle. For ncalrpc calls, Privs contains a string with the client's principal name.
The server application must cast the Privs parameter to the data type specified by the AuthnSvc parameter. The data referenced by this argument is read-only and should not be modified by the server application. If the server wants to preserve any of the returned data, the server must copy the data into server-allocated memory.
For more information on SSPs, see Security Support Providers (SSPs).
Returns a pointer to a pointer to the server principal name specified by the server application that called the RpcServerRegisterAuthInfo function. The content of the returned name and its syntax are defined by the authentication service in use. For the SCHANNEL SSP, the principal name is in msstd format. For further information on msstd format, see Principal Names.
Specify a null value to prevent RpcBindingInqAuthClientEx from returning the ServerPrincName parameter. In this case, the application does not call the RpcStringFree function.
Returns a pointer set to the level of authentication requested by the client application that made the remote procedure call on the ClientBinding binding handle. For a list of the RPC-supported authentication levels, see Authentication-Level Constants.
Specify a null value to prevent RpcBindingInqAuthClientEx from returning the AuthnLevel parameter.
Returns a pointer set to the authentication service requested by the client application that made the remote procedure call on the ClientBinding binding handle. For a list of the RPC-supported authentication services, see Authentication-Service Constants.
Specify a null value to prevent RpcBindingInqAuthClientEx from returning the AuthnSvc parameter.
Returns a pointer set to the authorization service requested by the client application that made the remote procedure call on the Binding binding handle. For a list of the RPC-supported authorization services, see Authorization-Service Constants .
Specify a null value to prevent RpcBindingInqAuthClientEx from returning the AuthzSvc parameter. This parameter is not used by the RPC_C_AUTHN_WINNT authentication service. The returned value will always be RPC_S_AUTHZ_NONE.
Controls the format of the principal name. This parameter can be set to the following value.
Value | Meaning |
---|---|
|
Passes back the principal name in fullsic format. |
Value | Meaning |
---|---|
|
The call succeeded. |
|
The binding handle was invalid. |
|
This was the wrong kind of binding for the operation. |
|
Binding has no authentication information. |
A server application calls the RpcBindingInqAuthClientEx function to obtain the principal name or privilege attributes of the authenticated client that made the remote procedure call. In addition, RpcBindingInqAuthClientEx returns the authentication service, authentication level, and server principal name specified by the client. The server can use the returned data for authorization purposes.
The RPC run-time library allocates memory for the returned ServerPrincName parameter. The application is responsible for calling the RpcStringFree function for the returned argument string.
For synchronous RPC calls, the server application can use zero as the value for the ClientBinding parameter. Using zero retrieves the authentication and authorization information from the currently executing remote procedure call.