Partager via


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)

Voir aussi

RpcServerRegisterAuthInfo