Fonction RpcMgmtSetAuthorizationFn (rpcdce.h)
La fonction RpcMgmtSetAuthorizationFn établit une fonction d’autorisation pour le traitement des appels distants aux fonctions de gestion d’un serveur.
Syntaxe
RPC_STATUS RpcMgmtSetAuthorizationFn(
RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);
Paramètres
AuthorizationFn
Spécifie une fonction d’autorisation. La bibliothèque d’exécution du serveur RPC appelle automatiquement cette fonction chaque fois que l’exécution du serveur reçoit une demande cliente d’exécuter l’une des fonctions de gestion à distance. Le serveur doit implémenter cette fonction. Les applications spécifient une valeur NULL pour annuler l’inscription d’une fonction d’autorisation précédemment inscrite. Après un tel appel, les autorisations par défaut sont utilisées.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
Remarques
Les applications serveur appellent la fonction RpcMgmtSetAuthorizationFn pour établir une fonction d’autorisation qui contrôle l’accès aux fonctions de gestion à distance du serveur. Lorsqu’un serveur n’a pas appelé RpcMgmtSetAuthorizationFn ou qu’il appelle avec une valeur null pour AuthorizationFn, la bibliothèque d’exécution du serveur utilise les autorisations par défaut suivantes.
| Fonction distante | Autorisation par défaut |
|---|---|
| RpcMgmtInqIfIds | activé |
| RpcMgmtInqServerPrincName | activé |
| RpcMgmtInqStats | activé |
| RpcMgmtIsServerListening | activé |
| RpcMgmtStopServerListening | Désactivé |
Dans le tableau précédent, « Activé » indique que tous les clients peuvent exécuter la fonction distante, et « Désactivé » indique que tous les clients ne peuvent pas exécuter la fonction distante.
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) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |