Metodo ICEnroll::get_ContainerName (xenroll.h)

  • Articolo

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà ContainerName imposta o recupera il nome del contenitore di chiavi da usare.

Questa proprietà è stata prima definita nell'interfaccia ICEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_ContainerName(
  BSTR *pbstrContainer
);

Parametri

pbstrContainer

Valore restituito

nessuno

Osservazioni

Il contenitore specificato può essere un contenitore esistente o uno nuovo. Può essere un contenitore esistente solo se la proprietà UseExistingKeySet è impostata, purché il set di chiavi non sia ancora stato generato. Ad esempio, se per un contenitore è stato generato solo un set di chiavi di scambio , è comunque possibile eseguire una registrazione del certificato usando il set di chiavi di firma senza impostare UseExistingKeySet. Il set di chiavi di scambio può essere usato se UseExistingKeySet è impostato in anticipo.

Per impostazione predefinita, viene selezionato un nuovo contenitore ogni volta che viene eseguito il controllo ICEnroll . Ciò garantisce che venga generato un nuovo set di chiavi. Se questa proprietà non è impostata in modo esplicito, viene usato un GUID generato come nome del contenitore.

La proprietà ContainerName influisce sul comportamento dei metodi seguenti:

Esempio

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll