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

  • Artigo

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

A propriedade RootStoreName define ou recupera o nome do repositório raiz em que todos os certificados raiz intrinsecamente confiáveis e autoassinados são mantidos.

O valor padrão dessa propriedade é "ROOT". Devido ao nível de confiança associado ao repositório raiz, o usuário pode ser solicitado (por meio da interface do usuário) a aceitar o certificado. Embora essa propriedade não precise ser alterada para muitos aplicativos, para evitar a interface do usuário associada a certificados raiz confiáveis, uma possibilidade é definir RootStoreName como "CA".

Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_RootStoreName(
  BSTR bstrName
);

Parâmetros

bstrName

Valor retornado

Nenhum

Comentários

RootStoreName afeta o comportamento dos seguintes métodos:

A capacidade de definir essa propriedade é desabilitada quando o Controle de Registro de Certificado é executado como um controle com script.

Exemplos

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RootStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RootStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName was set to : %ws\n", bstrNewName );

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll