MÉTHODE ICEnroll ::get_ContainerName (xenroll.h)

Article
03/04/2024

[Cette propriété n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La propriété ContainerName définit ou récupère le nom du conteneur de clé à utiliser.

Cette propriété a d’abord été définie dans l’interface ICEnroll .

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_ContainerName(
  BSTR *pbstrContainer
);

Paramètres

pbstrContainer

Valeur de retour

None

Remarques

Le conteneur spécifié peut être un conteneur existant ou nouveau. Il peut s’agir d’un conteneur existant uniquement si la propriété UseExistingKeySet est définie, tant que le jeu de clés n’a pas encore été généré. Par exemple, si seul un jeu de clés exchange a été généré pour un conteneur, il est toujours possible d’effectuer une inscription de certificat à l’aide du jeu de clés de signature sans définir UseExistingKeySet. Le jeu de clés d’échange peut être utilisé si UseExistingKeySet est défini à l’avance.

Par défaut, un nouveau conteneur est sélectionné chaque fois que le contrôle ICEnroll est exécuté. Cela garantit qu’un nouveau jeu de clés est généré. Si cette propriété n’est pas définie explicitement, un GUID généré est utilisé comme nom de conteneur.

La propriété ContainerName affecte le comportement des méthodes suivantes :

Exemples

BSTR     bstrContainerName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the container name
hr = pEnroll->get_ContainerName( &bstrContainerName );
if ( FAILED ( hr ) )
    printf("Failed getting ContainerName - %x\n", hr );
else
    printf( "ContainerName: %ws\n", bstrContainerName );
// free BSTR when done
if ( NULL != bstrContainerName )
    SysFreeString( bstrContainerName );

// set the container name
// bstrMyName previously set to a valid name
hr = pEnroll->put_ContainerName( bstrMyName );
if ( FAILED ( hr ) )
    printf("Failed setting ContainerName - %x\n", hr );
else
    printf( "ContainerName was set to %ws\n", bstrMyName );

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll

Partager via