RpcServerInqDefaultPrincName, fonction (rpcdce.h)
La fonction RpcServerInqDefaultPrincName obtient le nom de principal par défaut pour un service d’authentification donné.
Syntaxe
RPC_STATUS RpcServerInqDefaultPrincName(
unsigned long AuthnSvc,
RPC_WSTR *PrincName
);
Paramètres
AuthnSvc
Service d’authentification à utiliser lorsque le serveur reçoit une demande d’appel de procédure distante.
PrincName
En cas de réussite, contient le nom de principal par défaut pour le service d’authentification donné, tel que spécifié par le paramètre AuthnSvc . Le service d’authentification utilisé définit le contenu du nom et sa syntaxe. Ce nom principal doit être utilisé comme paramètre ServerPrincName de la fonction RpcServerRegisterAuthInfo . Si la fonction réussit, PrincName doit être libéré à l’aide de la fonction RpcStringFree . Si la fonction échoue, le contenu de PrincName n’est pas défini et l’appelant n’a aucune obligation de le libérer.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
La mémoire est insuffisante pour terminer l’opération. |
Remarques
Cette fonction est la méthode recommandée pour obtenir le nom de principal du serveur à passer à la fonction RpcServerRegisterAuthInfo . Bien que la composition du nom du principal du serveur soit possible sans utiliser cette fonction, l’appel de la fonction est plus facile et plus portable entre les versions du système d’exploitation.
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 |