Metodo IX509EnrollmentPolicyServer::SetCredential (certenroll.h)

Articolo
02/23/2024

Il metodo SetCredential imposta le credenziali usate per contattare il server CEP (Certificate Enrollment Policy).

Sintassi

HRESULT SetCredential(
  [in] LONG                    hWndParent,
  [in] X509EnrollmentAuthFlags flag,
  [in] BSTR                    strCredential,
  [in] BSTR                    strPassword
);

Parametri

[in] hWndParent

Handle finestra padre.

[in] flag

Valore di enumerazione X509EnrollmentAuthFlags che specifica il tipo di autenticazione. Questo può essere uno dei valori seguenti.

Valore	Significato
X509AuthAnonymous	Autenticazione anonima. Impostare i parametri strCredential e strPassword su NULL.
X509AuthKerberos	Autenticazione Kerberos. Impostare i parametri strCredential e strPassword su NULL.
X509AuthUsername	Cancellare il nome utente e l'autenticazione della password. Impostare i parametri strCredential e strPassword sul nome utente e sulla password associata. Queste stringhe vengono crittografate prima della trasmissione e vengono archiviate in modo sicuro nell'insieme di credenziali nel server CEP.
X509AuthCertificate	Certificato di autenticazione client installato nel computer locale e usato dal server per verificare l'identità del client. Impostare il parametro strPassword su NULL e impostare l'identificazione personale del certificato, un hash SHA1 a 20 byte del certificato, nel parametro strCredential .

[in] strCredential

Variabile BSTR che contiene le credenziali.

[in] strPassword

Variabile BSTR contenente la password.

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 restituito	Descrizione
E_INVALIDARG	Il parametro flag non è un valore supportato.

Commenti

Gli argomenti strCredential e strPassword cambieranno a seconda del valore specificato nell'argomento flag , come illustrato nella tabella seguente.

parametro flag	parametro strCredential	parametro strPassword
X509AuthAnonymous	NULL	NULL
X509AuthKerberos	NULL	NULL
X509AuthUsername	Cancellare il nome utente di testo riconosciuto dal server CEP.	Cancellare la password di testo associata al nome utente.
X509AuthCertificate	Contiene un hash SHA-1 di 20 byte (identificazione personale) del certificato.	NULL

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenroll.h

Vedi anche

IX509EnrollmentPolicyServer

Condividi tramite