RPC_AUTH_KEY_RETRIEVAL_FN fonction de rappel (rpcdce.h)
La fonction RPC_AUTH_KEY_RETRIEVAL_FN est un prototype pour une fonction qui spécifie l’adresse d’une routine fournie par l’application serveur retournant des clés de chiffrement.
Syntaxe
RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;
void RpcAuthKeyRetrievalFn(
void *Arg,
RPC_WSTR ServerPrincName,
unsigned long KeyVer,
void **Key,
RPC_STATUS *Status
)
{...}
Paramètres
Arg
Pointeur vers un argument défini par l’utilisateur vers la fonction d’acquisition de clé de chiffrement fournie par l’utilisateur. La bibliothèque d’exécution RPC utilise le paramètre Arg fourni à RpcServerRegisterAuthInfo.
ServerPrincName
Pointeur vers le nom principal à utiliser pour le serveur lors de l’authentification des appels de procédure distante. La bibliothèque d’exécution RPC utilise le paramètre ServerPrincName fourni à RpcServerRegisterAuthInfo.
KeyVer
Valeur que la bibliothèque d’exécution RPC fournit automatiquement pour le paramètre key-version. Lorsque la valeur est égale à zéro, la fonction d’acquisition doit retourner la clé la plus récente disponible.
Key
Pointeur vers un pointeur vers la clé d’authentification retournée par la fonction fournie par l’utilisateur.
Status
Pointeur vers le status retourné par la fonction d’acquisition lorsqu’elle est appelée par la bibliothèque d’exécution RPC pour authentifier la requête RPC cliente. Si le status n’est pas RPC_S_OK, la requête échoue et la bibliothèque d’exécution retourne l’erreur status à l’application cliente.
Valeur de retour
None
Remarques
Une fonction de récupération de clé d’autorisation spécifie l’adresse d’une routine fournie par l’application serveur retournant des clés de chiffrement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |