Méthode ICEnroll::p ut_ContainerName (xenroll.h)

Article
08/28/2023

[Cette propriété n’est plus disponible à partir de 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 put_ContainerName(
  BSTR bstrContainer
);

Paramètres

bstrContainer

Valeur de retour

None

Remarques

Le conteneur spécifié peut être un conteneur existant ou un 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 exchange 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 );

Spécifications


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