RpcCertGeneratePrincipalNameW, fonction (rpcssl.h)
Les programmes serveur utilisent la fonction RpcCertGeneratePrincipalName pour générer noms de principaux pour les certificats de sécurité.
Syntaxe
RPC_STATUS RpcCertGeneratePrincipalNameW(
PCCERT_CONTEXT Context,
DWORD Flags,
RPC_WSTR *pBuffer
);
Paramètres
Context
Pointeur vers le contexte de certificat de sécurité.
Flags
Actuellement, le seul indicateur valide pour ce paramètre est RPC_C_FULL_CERT_CHAIN. L’utilisation de cet indicateur entraîne la génération du nom du principal au format complet.
pBuffer
Pointeur vers un pointeur. La fonction RpcCertGeneratePrincipalName définit cette valeur pour qu’elle pointe vers une chaîne terminée par null qui contient le nom de principal .
Valeur de retour
Cette fonction ne retourne pas de valeur.
Remarques
Par défaut, le nom principal que la fonction RpcCertGeneratePrincipalName passe est au format msstd. Pour générer un nom au format complet, transmettez RPC_C_FULL_CERT_CHAIN comme valeur pour le paramètre Flags.
Votre application doit appeler RpcStringFree pour libérer la mémoire de la chaîne qui contient le nom du principal.
Note
L’en-tête rpcssl.h définit RpcCertGeneratePrincipalName 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 | rpcssl.h (include Rpc.h) |
| bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |