X509CertificateInitiatorServiceCredential.SetCertificate Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta il certificato da utilizzare per crittografare i messaggi inviati al client dal servizio. Questa impostazione viene usata solo dalle associazioni configurate con la modalità di autenticazione di sicurezza dei MutualCertificateDuplex messaggi.
Overload
| Nome | Descrizione |
|---|---|
| SetCertificate(String, StoreLocation, StoreName) |
Consente di specificare il certificato da usare per crittografare i messaggi per il client specificando il nome distinto del soggetto. Questa impostazione viene usata solo dalle associazioni configurate con la modalità di autenticazione di sicurezza dei |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Specifica il certificato da utilizzare per crittografare i messaggi per il client. Questa impostazione viene usata solo dalle associazioni configurate con la modalità di autenticazione di sicurezza dei |
SetCertificate(String, StoreLocation, StoreName)
Consente di specificare il certificato da usare per crittografare i messaggi per il client specificando il nome distinto del soggetto. Questa impostazione viene usata solo dalle associazioni configurate con la modalità di autenticazione di sicurezza dei MutualCertificateDuplex messaggi.
public:
void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);
public void SetCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);
member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit
Public Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)
Parametri
- subjectName
- String
Nome distinto dell'oggetto.
- storeLocation
- StoreLocation
Percorso dell'archivio certificati usato dal servizio per ottenere il certificato.
- storeName
- StoreName
Nome dell'archivio certificati X.509 da aprire.
Esempio
Il codice seguente illustra come usare questo metodo per impostare il certificato.
Commenti
Per ulteriori informazioni sul parametro subjectName, vedere SubjectName.
I valori per storeLocation sono inclusi nell'enumerazione StoreLocation :
LocalMachine: archivio certificati assegnato al computer locale (impostazione predefinita).
CurrentUser: l'archivio certificati usato dall'utente corrente.
Se l'applicazione client è in esecuzione con un account di sistema, il certificato è in genere in LocalMachine. Se l'applicazione client è in esecuzione con un account utente, il certificato è in genere in CurrentUser.
I valori per storeName sono inclusi nell'enumerazione StoreName .
Si applica a
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Specifica il certificato da utilizzare per crittografare i messaggi per il client. Questa impostazione viene usata solo dalle associazioni configurate con la modalità di autenticazione di sicurezza dei MutualCertificateDuplex messaggi.
public:
void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);
public void SetCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);
member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit
Public Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)
Parametri
- storeLocation
- StoreLocation
Percorso dell'archivio certificati usato dal servizio per ottenere il certificato.
- storeName
- StoreName
Nome dell'archivio certificati X.509 da aprire.
- findType
- X509FindType
Tipo di ricerca X.509 da eseguire.
- findValue
- Object
Valore da cercare nell'archivio certificati X.509.
Esempio
Il codice seguente illustra come usare questo metodo per impostare il certificato.
Commenti
I valori per storeLocation sono inclusi nell'enumerazione StoreLocation :
LocalMachine: archivio certificati assegnato al computer locale (impostazione predefinita).
CurrentUser: l'archivio certificati usato dall'utente corrente.
Se l'applicazione è in esecuzione con un account di sistema, il certificato è in genere in LocalMachine. Se l'applicazione è in esecuzione con un account utente, il certificato è in genere in CurrentUser.
I valori per storeName sono inclusi nell'enumerazione StoreName .
I valori per findType sono inclusi nell'enumerazione X509FindType .
L'enumerazione più comunemente usata è FindBySubjectName, che esegue una ricerca senza distinzione tra maiuscole e minuscole sul nome soggetto dei certificati nell'archivio specificato. Può trattarsi di una ricerca imprecisa. Se non vengono trovati certificati o più certificati che soddisfano i criteri, viene generata un'eccezione InvalidOperationException .