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

Voir aussi

Noms principaux

RpcStringFree