Método ICEnroll::p ut_SPCFileName (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 SPCFileName define ou recupera o nome do arquivo no qual gravar o PKCS nº 7 codificado em base64 (no formato BSTR ) conforme retornado da autoridade de certificação.

Essa propriedade foi definida pela primeira vez na interface ICEnroll .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_SPCFileName(
  BSTR bstr
);

Parâmetros

bstr

Valor retornado

Nenhum

Comentários

O arquivo é gravado como um PKCS binário nº 7. Especificar esse arquivo não afeta a aceitação dos certificados em nenhum dos repositórios do usuário.

Se o arquivo já existir, o usuário será notificado e solicitado a conceder permissão para substituí-lo.

SPCFileName afeta o comportamento dos seguintes métodos:

Exemplos

BSTR     bstrSPCFile = NULL;
BSTR     bstrNewSPCFile = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

// set the SPCFileName, for example, "MyFile.SPC".
bstrNewSPCFile = SysAllocString(TEXT("<FILENAMEHERE>"));

hr = pEnroll->put_SPCFileName( bstrNewSPCFile );
if (FAILED( hr ))
    printf("Failed put_SPCFileName - %x\n", hr );
else
    printf( "SPCFileName set to %ws\n", bstrNewSPCFile );
// free BSTR when done
if ( NULL != bstrNewSPCFile )
    SysFreeString( bstrNewSPCFile );

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