Metodo ICertProperty::RemoveFromCertificate (certenroll.h)

Articolo
02/28/2024

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
CRYPT_E_NOT_FOUND	Impossibile trovare il certificato.
CRYPT_E_UNEXPECTED_MSG_TYPE	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

Vedi anche

ICertProperties

ICertProperty

Condividi tramite