RPC_IF_CALLBACK_FN fonction de rappel (rpcdce.h)

Article
03/13/2024

Le RPC_IF_CALLBACK_FN est un prototype d’une fonction de rappel de sécurité que votre application fournit. Votre programme peut fournir une fonction de rappel pour chaque interface qu’il définit.

Syntaxe

RPC_IF_CALLBACK_FN RpcIfCallbackFn;

RPC_STATUS RpcIfCallbackFn(
       RPC_IF_HANDLE InterfaceUuid,
  [in] void *Context
)
{...}

Paramètres

InterfaceUuid

[in] Context

Pointeur vers un handle de liaison de serveur RPC_IF_ID représentant le client. Dans la déclaration de fonction, cela doit être de type RPC_IF_HANDLE, mais il s’agit d’un handle de liaison client et peut être converti en toute sécurité vers celui-ci. La fonction de rappel peut passer ce handle à RpcImpersonateClient, RpcBindingServerFromClient, RpcGetAuthorizationContextForClient ou toute autre fonction côté serveur qui accepte un handle de liaison client pour obtenir des informations sur le client.

Valeur retournée

La fonction de rappel doit retourner RPC_S_OK si le client est autorisé à appeler des méthodes dans cette interface. Tout autre code de retour entraîne la réception par le client de l’exception RPC_S_ACCESS_DENIED.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Remarques

Dans certains cas, l’exécution rpc peut appeler la fonction de rappel de sécurité plusieurs fois par client et par interface. Assurez-vous que votre fonction de rappel peut gérer cette possibilité.

Le rappel de sécurité doit être déclaré comme RPC_ENTRY.

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

RpcServerRegisterIfEx

Partager via