Compartir a través de


Método ICEnroll::get_ContainerName (xenroll.h)

[Esta propiedad ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La propiedad ContainerName establece o recupera el nombre del contenedor de claves que se va a usar.

Esta propiedad se definió por primera vez en la interfaz ICEnroll .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_ContainerName(
  BSTR *pbstrContainer
);

Parámetros

pbstrContainer

Valor devuelto

None

Observaciones

El contenedor especificado puede ser un contenedor existente o uno nuevo. Solo puede ser un contenedor existente si se establece la propiedad UseExistingKeySet , siempre y cuando el conjunto de claves aún no se haya generado. Por ejemplo, si solo se ha generado un conjunto de claves de intercambio para un contenedor, todavía es posible realizar una inscripción de certificado mediante el conjunto de claves de firma sin establecer UseExistingKeySet. El conjunto de claves de intercambio se puede usar si UseExistingKeySet se establece de antemano.

De forma predeterminada, se selecciona un nuevo contenedor cada vez que se ejecuta el control ICEnroll . Esto garantiza que se genere un nuevo conjunto de claves. Si esta propiedad no se establece explícitamente, se usa un GUID generado como nombre de contenedor.

La propiedad ContainerName afecta al comportamiento de los métodos siguientes:

Ejemplos

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado xenroll.h
Library Uuid.lib
Archivo DLL Xenroll.dll