Metodo ICEnroll4::createPFX (xenroll.h)

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

Il metodo createPFX salva la catena di certificati accettata e la chiave privata in una stringa di formato PFX (Personal Information Exchange). Il formato PFX è noto anche come PKCS #12.

Questo metodo è stato definito per la prima volta nell'interfaccia ICEnroll4 .

Sintassi

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Parametri

[in] strPassword

Password per il messaggio in formato PFX. Questo valore può essere vuoto o NULL per indicare che non viene usata alcuna password. Al termine dell'uso della password, cancellarla dalla memoria chiamando la funzione SecureZeroMemory . Per altre informazioni sulla protezione della password, vedere Gestione delle password.

[out] pstrPFX

Puntatore a un BSTR che riceve le informazioni del certificato PFX con codifica base64. Al termine dell'uso della funzione BSTR, liberarla chiamando la funzione SysFreeString .

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un valore String che contiene le informazioni sul certificato di formato PFX.

Commenti

Questo metodo viene disabilitato quando viene eseguito il controllo registrazione certificati come controllo script.

Requisiti

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