ICEnroll::get_ContainerName-Methode (xenroll.h)

Artikel
03/13/2024

[Diese Eigenschaft ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

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 get_ContainerName(
  BSTR *pbstrContainer
);

Parameter

pbstrContainer

Rückgabewert

Keine

Bemerkungen

Bei dem angegebenen Container kann es sich um einen vorhandenen oder einen neuen Container handelt. Es kann nur ein vorhandener Container sein, 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 mit dem Signaturschlüsselsatz durchzuführen, ohne UseExistingKeySet festzulegen. Der Austauschschlüsselsatz kann verwendet werden, wenn UseExistingKeySet im Voraus 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

Anforderung	Wert
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