Metodo ICertProperty::RemoveFromCertificate (certenroll.h)
Il metodo RemoveFromCertificate annulla l'accesso a una proprietà da un certificato. Specificare la proprietà da rimuovere chiamando la proprietà PropertyId .
Sintassi
HRESULT RemoveFromCertificate(
[in] VARIANT_BOOL MachineContext,
[in] EncodingType Encoding,
[in] BSTR strCertificate
);
Parametri
[in] MachineContext
Valore VARIANT_BOOL che indica se l'archivio certificati si trova nel computer locale. Specificare VARIANT_TRUE se l'archivio è locale.
[in] Encoding
Valore di enumerazione EncodingType che specifica il tipo di codifica applicato alla stringa di certificato identificata dal parametro strCertificate .
[in] strCertificate
Variabile BSTR contenente il certificato con codifica DER.
A partire da Windows 7 e Windows Server 2008 R2, è possibile specificare una stampa personale del certificato o un numero di serie anziché un certificato codificato. In questo modo, la funzione cerca gli archivi locali appropriati per il certificato corrispondente. Tenere presente quanto segue:
- BSTR deve essere un numero pari di cifre esadecimali.
- Lo spazio vuoto tra coppie esadecimali viene ignorato.
- Il parametro Codifica deve essere impostato su XCN_CRYPT_STRING_HEXRAW.
- Il parametro MachineContext determina se l'utente o gli archivi computer o entrambi vengono cercati.
- Se è necessaria una chiave privata, vengono cercati solo gli archivi personali e delle richieste.
- Se non è necessaria una chiave privata, vengono inoltre cercati gli archivi ca radice e intermedi.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.
Codice/valore restituito | Descrizione |
---|---|
|
Impossibile trovare il certificato. |
|
Il certificato è stato trovato, ma non è stato possibile caricare la chiave privata. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | certenroll.h |
DLL | CertEnroll.dll |