Método ICEnroll::p ut_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 put_ContainerName(
BSTR bstrContainer
);
Parámetros
bstrContainer
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 del 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
| 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 |