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

  • Artigo

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

A propriedade RequestStoreName define ou recuperaICEnroll o nome do repositório que contém o certificado fictício. Esse certificado fictício, juntamente com as chaves privadas adicionadas, permanece no repositório de solicitações até que uma autoridade de certificação processe a solicitação e responda com um PKCS nº 7.

O valor padrão dessa propriedade é "REQUEST". Se o padrão não for usado, essa propriedade deverá ser definida como o repositório a ser usado antes das chamadas para createPKCS10 ou createFilePKCS10 e novamente antes das chamadas para acceptPKCS7 ou acceptFilePKCS7.

Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_RequestStoreName(
  BSTR *pbstrName
);

Parâmetros

pbstrName

Valor retornado

Nenhum

Comentários

Normalmente, a modificação da propriedade RequestStoreName é executada somente em aplicativos avançados. A alteração desse valor não é recomendada para a maioria dos aplicativos.

A propriedade RequestStoreName 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_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %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_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

Requisitos

   
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