RPC_AUTH_KEY_RETRIEVAL_FN回调函数 (rpcdce.h)

RPC_AUTH_KEY_RETRIEVAL_FN 函数是函数的原型,该函数指定服务器应用程序提供的返回加密密钥的例程的地址。

语法

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

void RpcAuthKeyRetrievalFn(
  void *Arg,
  RPC_WSTR ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
)
{...}

参数

Arg

指向用户提供的加密密钥获取函数的用户定义参数的指针。 RPC 运行时库使用提供给 RpcServerRegisterAuthInfoArg 参数。

ServerPrincName

指向在对远程过程调用进行身份验证时要用于服务器的主体名称的指针。 RPC 运行时库使用提供给 RpcServerRegisterAuthInfoServerPrincName 参数。

KeyVer

RPC 运行时库自动为密钥版本参数提供的值。 当值为零时,购置函数必须返回最新的可用键。

Key

指向用户提供的函数返回的身份验证密钥的指针的指针。

Status

指向 RPC 运行时库调用获取函数以对客户端 RPC 请求进行身份验证时返回的状态的指针。 如果状态不是RPC_S_OK,则请求失败,运行时库会将错误状态返回到客户端应用程序。

返回值

备注

授权密钥检索函数指定服务器应用程序提供的返回加密密钥的例程的地址。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 rpcdce.h (包括 Rpc.h)

另请参阅

RpcServerRegisterAuthInfo