Metodo IX509EnrollmentPolicyServer::SetCredential (certenroll.h)

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

  • Last updated on