RPC_AUTH_KEY_RETRIEVAL_FN función de devolución de llamada (rpcdce.h)
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) |