RPC_AUTH_KEY_RETRIEVAL_FN callback function

The RPC_AUTH_KEY_RETRIEVAL_FN function is a prototype for a function that specifies the address of a server-application-provided routine returning encryption keys.

Syntax


void CALLBACK RpcAuthKeyRetrievalFn(
  void *Arg,
  unsigned char *ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
);

Parameters

Arg

Pointer to a user-defined argument to the user-supplied encryption key acquisition function. The RPC run-time library uses the Arg parameter supplied to RpcServerRegisterAuthInfo.

ServerPrincName

Pointer to the principal name to use for the server when authenticating remote procedure calls. The RPC run-time library uses the ServerPrincName parameter supplied to RpcServerRegisterAuthInfo.

KeyVer

Value that the RPC run-time library automatically provides for the key-version parameter. When the value is zero, the acquisition function must return the most recent key available.

Key

Pointer to a pointer to the authentication key returned by the user-supplied function.

Status

Pointer to the status returned by the acquisition function when it is called by the RPC run-time library to authenticate the client RPC request. If the status is other than RPC_S_OK, the request fails and the run-time library returns the error status to the client application.

Return value

This callback function does not return a value.

Remarks

An authorization key–retrieval function specifies the address of a server-application-provided routine returning encryption keys.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

See also

RpcServerRegisterAuthInfo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft