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

  • Artigo

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

A propriedade WriteCertToCSP define ou recupera um valor booliano que determina se um certificado deve ser gravado no provedor de serviços criptográficos (CSP).

Essa propriedade foi definida pela primeira vez pela interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_WriteCertToCSP(
  BOOL fBool
);

Parâmetros

fBool

Valor retornado

Nenhum

Comentários

Normalmente, essa propriedade é usada com cartões inteligentes, em que o certificado é gravado no cartão inteligente, além de ser gravado no repositório "MY".

O valor padrão é true, o que significa que o Controle de Registro de Certificado tentará gravar o certificado no CSP, mas não falhará, a menos que um erro de token de hardware seja encontrado. Se esse valor for true, mas nenhum cartão inteligente ou outro CSP dependente de hardware estiver instalado, os erros de token de hardware serão ignorados.

Para forçar explicitamente que o Controle de Registro de Certificado não tente gravar no CSP, defina esse valor como false.

WriteCertToCSP afeta o comportamento dos seguintes métodos:

Exemplos

BOOL     bWriteCSP;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the WriteCertToCSP value
hr = pEnroll->get_WriteCertToCSP( &bWriteCSP );
if (FAILED( hr ))
    printf("Failed get_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP: %d\n", bWriteCSP );

// set the WriteCertToCSP value
hr = pEnroll->put_WriteCertToCSP( TRUE );
if (FAILED( hr ))
    printf("Failed put_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP set to TRUE\n" );

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