RpcServerInqDefaultPrincNameA, fonction (rpcdce.h)
La fonction RpcServerInqDefaultPrincName obtient le nom de principal par défaut d’un service d’authentification donné.
Syntaxe
RPC_STATUS RpcServerInqDefaultPrincNameA(
unsigned long AuthnSvc,
RPC_CSTR *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 du service d’authentification donné, tel que spécifié par le paramètre AuthnSvc. Le service d’authentification en cours d’utilisation 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ée à l’aide de la fonction RpcStringFree. Si la fonction échoue, le contenu de PrincName n’est pas défini et l’appelant n’a pas l’obligation de le libérer.
Valeur de retour
| 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 du 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.
Note
L’en-tête rpcdce.h définit RpcServerInqDefaultPrincName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | rpcdce.h (inclure Rpc.h) |
| bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |