RPC_AUTH_KEY_RETRIEVAL_FN función de devolución de llamada (rpcdce.h)

Artículo
08/25/2023

La función RPC_AUTH_KEY_RETRIEVAL_FN es un prototipo de una función que especifica la dirección de una rutina proporcionada por la aplicación de servidor que devuelve claves de cifrado.

Sintaxis

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

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

Parámetros

Arg

Puntero a un argumento definido por el usuario a la función de adquisición de claves de cifrado proporcionada por el usuario. La biblioteca en tiempo de ejecución rpc usa el parámetro Arg proporcionado a RpcServerRegisterAuthInfo.

ServerPrincName

Puntero al nombre principal que se va a usar para el servidor al autenticar llamadas a procedimientos remotos. La biblioteca en tiempo de ejecución rpc usa el parámetro ServerPrincName proporcionado a RpcServerRegisterAuthInfo.

KeyVer

Valor que la biblioteca en tiempo de ejecución rpc proporciona automáticamente para el parámetro key-version. Cuando el valor es cero, la función de adquisición debe devolver la clave más reciente disponible.

Key

Puntero a un puntero a la clave de autenticación devuelta por la función proporcionada por el usuario.

Status

Puntero al estado devuelto por la función de adquisición cuando la biblioteca en tiempo de ejecución RPC llama a ella para autenticar la solicitud RPC del cliente. Si el estado es distinto de RPC_S_OK, se produce un error en la solicitud y la biblioteca en tiempo de ejecución devuelve el estado de error a la aplicación cliente.

Valor devuelto

None

Observaciones

Una función de recuperación de clave de autorización especifica la dirección de una rutina proporcionada por la aplicación de servidor que devuelve claves de cifrado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (include Rpc.h)

Consulte también

RpcServerRegisterAuthInfo