ICEnroll::p ut_ContainerName-Methode (xenroll.h)

Artikel
08/28/2023

[Diese Eigenschaft steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die ContainerName-Eigenschaft legt den Namen des zu verwendenden Schlüsselcontainers fest oder ruft diesen ab.

Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_ContainerName(
  BSTR bstrContainer
);

Parameter

bstrContainer

Rückgabewert

Keine

Bemerkungen

Bei dem angegebenen Container kann es sich um einen vorhandenen oder einen neuen Container handelt. Es kann sich nur um einen vorhandenen Container handelt, wenn die UseExistingKeySet-Eigenschaft festgelegt ist, solange der Schlüsselsatz noch nicht generiert wurde. Wenn beispielsweise nur ein Exchange-Schlüsselsatz für einen Container generiert wurde, ist es weiterhin möglich, eine Zertifikatregistrierung mithilfe des Signaturschlüsselsatzes durchzuführen, ohne UseExistingKeySet festzulegen. Der Exchange-Schlüsselsatz kann verwendet werden, wenn UseExistingKeySet zuvor festgelegt wurde.

Standardmäßig wird bei jeder Ausführung des ICEnroll-Steuerelements ein neuer Container ausgewählt. Dadurch wird sichergestellt, dass ein neuer Schlüsselsatz generiert wird. Wenn diese Eigenschaft nicht explizit festgelegt ist, wird eine generierte GUID als Containername verwendet.

Die ContainerName-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:

Beispiele

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 );

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über