Método ICEnroll::p ut_ContainerName (xenroll.h)

[Essa propriedade não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

A propriedade ContainerName define ou recupera o nome do contêiner de chaves a ser usado.

Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_ContainerName(
  BSTR bstrContainer
);

Parâmetros

bstrContainer

Valor retornado

Nenhum

Comentários

O contêiner especificado pode ser um contêiner existente ou um novo. Ele só poderá ser um contêiner existente se a propriedade UseExistingKeySet estiver definida, desde que o conjunto de chaves ainda não tenha sido gerado. Por exemplo, se apenas um conjunto de chaves de troca tiver sido gerado para um contêiner, ainda será possível executar um registro de certificado usando o conjunto de chaves de assinatura sem definir UseExistingKeySet. O conjunto de chaves de troca poderá ser usado se UseExistingKeySet for definido com antecedência.

Por padrão, um novo contêiner é selecionado sempre que o controle ICEnroll é executado. Isso garante que um novo conjunto de chaves seja gerado. Se essa propriedade não estiver definida explicitamente, um GUID gerado será usado como o nome do contêiner.

A propriedade ContainerName afeta o comportamento dos seguintes métodos:

• createPKCS10
• createFilePKCS10

Exemplos

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