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

  • Artigo

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

A propriedade DeleteRequestCert define ou recupera um valor booliano que determina se os certificados fictícios no repositório de solicitações são excluídos.

Certificados fictícios são criados com a finalidade de persistir as chaves geradas para a solicitação PKCS nº 10 durante o processo de registro. O repositório especificado pela propriedade RequestStoreName é onde o certificado fictício é criado. As chaves recém-geradas são adicionadas como propriedades ao certificado fictício para mantê-las até que uma autoridade de certificação processe a solicitação e responda com um PKCS nº 7. Na aceitação do PKCS nº 7, o certificado fictício é removido e as chaves são adicionadas como propriedades do certificado emitido retornado pela autoridade de certificação. Para depuração e teste, geralmente é desejável não excluir o certificado fictício. Definir a propriedade DeleteRequestCert como FALSE impede sua exclusão.

O valor padrão dessa propriedade é TRUE. Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_DeleteRequestCert(
  BOOL *fDelete
);

Parâmetros

fDelete

Valor retornado

Nenhum

Comentários

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

Exemplos

BOOL     bDRC;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll interface pointer.
// Get the DeleteRequestCert Boolean value.

hr = pEnroll->get_DeleteRequestCert( &bDRC );
if ( FAILED ( hr ) )
    printf("Failed getting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert: %s\n", ( bDRC ? "TRUE" : "FALSE" ) );


// Set the DeleteRequestCert value.

hr = pEnroll->put_DeleteRequestCert( FALSE );
if ( FAILED ( hr ) )
    printf("Failed Setting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert was set to FALSE\n" );

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