RpcMgmtInqDefaultProtectLevel
The RpcMgmtInqDefaultProtectLevel
function returns the default authentication level for an authentication
service.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtInqDefaultProtectLevel(
|
unsigned int AuthnSvc, |
|
|
unsigned int * AuthnLevel |
|
|
); |
|
Parameters
AuthnSvc
Specifies the
authentication service for which to return the default authentication level.
Possible values are as follows:
|
Value |
Description |
|
RPC_C_AUTHN_NONE
|
No
authentication |
|
RPC_C_AUTHN_WINNT
|
32-bit
Windows authentication service |
AuthnLevel
Returns the
default authentication level for the specified authentication service. The
authentication level determines the degree to which authenticated
communications between the client and server are protected. Possible values are
as follows:
|
Value |
Description |
|
RPC_C_AUTHN_LEVEL_DEFAULT
|
Uses the
default authentication level for the specified authentication service. |
|
RPC_C_AUTHN_LEVEL_NONE
|
Performs no
authentication. |
|
RPC_C_AUTHN_LEVEL_CONNECT
|
Authenticates
only when the client establishes a relationship witha server. |
|
RPC_C_AUTHN_LEVEL_CALL
|
Authenticates
only at the beginning of each remote procedure call when the server receives
the request. Does not apply to remote procedure calls made using the
connection-based protocol sequences that start with the prefix ncacn. If the
protocol sequence in a binding is a connection-based protocol sequence and
you specify this level, this routine instead uses the RPC_C_AUTHN_LEVEL_PKT
constant. |
|
RPC_C_AUTHN_LEVEL_PKT |
Authenticates
that all data received is from the expected client. |
|
RPC_C_AUTHN_LEVEL_PKT |
Authenticates
and verifies that none of the data transferred between client and server has
been modified. |
|
RPC_C_AUTHN_LEVEL_PKT |
Authenticates
all previous levels and encrypts the argument value of each remote procedure
call. |
Note
RPC_C_AUTHN_LEVEL_CALL, RPC_C_AUTHN_LEVEL_PKT,
RPC_C_AUTHN_LEVEL_PKT_INTEGRITY, and RPC_C_AUTHN_LEVEL_PKT_PRIVACY are only
supported for clients communicating with a Windows NT server. A Windows 95
server can only accept incoming calls at the RPC_C_AUTHN_LEVEL_CONNECT level.
Remarks
An
application calls the RpcMgmtInqDefaultProtectLevel routine to obtain
the default authentication level for a specified authentication service.
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success |
|
RPC_S_UNKNOWN_AUTH_SERVICE |
Unknown
authentication service |