Fonction RpcCertGeneratePrincipalName (rpcssl.h)
Les programmes serveur utilisent la fonction RpcCertGeneratePrincipalName pour générer des noms de principaux pour les certificats de sécurité.
Syntaxe
RPC_STATUS RpcCertGeneratePrincipalName(
PCCERT_CONTEXT Context,
DWORD Flags,
RPC_CSTR *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 principal au format complet.
pBuffer
Pointeur vers un pointeur. La fonction RpcCertGeneratePrincipalName définit ce paramètre pour qu’il pointe vers une chaîne terminée par null qui contient le nom du principal.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
Par défaut, le nom principal que la fonction RpcCertGeneratePrincipalName transmet est au format msstd. Pour générer un nom au format complet, passez 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 principal.
Spécifications
| 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 | rpcssl.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |