Metodo IEnroll4::createPFXWStr (xenroll.h)

  • Articolo

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

Il metodo createPFXWStr 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 IEnroll4 .

Sintassi

HRESULT createPFXWStr(
  [in]  LPCWSTR          pwszPassword,
  [out] PCRYPT_DATA_BLOB pblobPFX
);

Parametri

[in] pwszPassword

Puntatore a una stringa Unicode con terminazione null che rappresenta la 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, rimuovere le informazioni riservate dalla memoria chiamando SecureZeroMemory. Per altre informazioni sulla protezione della password, vedere Gestione delle password.

[out] pblobPFX

Puntatore alla struttura CRYPT_DATA_BLOB che riceve le informazioni del certificato PFX con codifica base64.

Al termine dell'uso di questa memoria, liberarlo passando il membro pbData di questa struttura alla funzione CoTaskMemFree .

Valore restituito

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.

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

Vedi anche

IEnroll4