Metodo ICEnroll::get_SPCFileName (xenroll.h)

  • Articolo

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà SPCFileName imposta o recupera il nome del file a cui scrivere pkCS #7 con codifica base64 (in formato BSTR ) come restituito dall'autorità di certificazione.

Questa proprietà è stata prima definita nell'interfaccia ICEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_SPCFileName(
  BSTR *pbstr
);

Parametri

pbstr

Valore restituito

nessuno

Osservazioni

Il file viene scritto come PKCS #7 binario. La specifica di questo file non influisce sull'accettazione dei certificati in uno degli archivi dell'utente.

Se il file esiste già, l'utente riceve una notifica e richiede l'autorizzazione per sovrascriverla.

SPCFileName influisce sul comportamento dei metodi seguenti:

Esempio

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 );

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll