X509CertificateRecipientClientCredential.SetScopedCertificate Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger ett certifikat från ett arkiv och lagrar det i en samling som indexeras av URL:en som anger omfånget.
Överlagringar
| Name | Description |
|---|---|
| SetScopedCertificate(String, StoreLocation, StoreName, Uri) |
Anger ett certifikat efter ämnesnamn, plats för certifikatarkivet och certifikatarkivets namn och lagrar det i en samling som ska användas för den URL som anger omfånget. |
| SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri) |
Anger ett certifikat efter certifikatarkivplats, certifikatarkivets namn, typ av X.509-sökning och värde att söka efter och lagrar det i en samling som ska användas för den URL som anger omfånget. |
SetScopedCertificate(String, StoreLocation, StoreName, Uri)
Anger ett certifikat efter ämnesnamn, plats för certifikatarkivet och certifikatarkivets namn och lagrar det i en samling som ska användas för den URL som anger omfånget.
public:
void SetScopedCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, Uri ^ targetService);
public void SetScopedCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, Uri targetService);
member this.SetScopedCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * Uri -> unit
Public Sub SetScopedCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName, targetService As Uri)
Parametrar
- subjectName
- String
Det fullständigt kvalificerade ämnesnamnet.
- storeLocation
- StoreLocation
Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.
- storeName
- StoreName
Namnet på X.509-certifikatarkivet som ska öppnas.
- targetService
- Uri
Den URL som anger omfånget.
Undantag
subjectName eller targetService är null.
Försökte ange när autentiseringsuppgifterna är skrivskyddade.
Exempel
Den här koden visar hur du anropar den här metoden.
public void snippet25(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetScopedCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople,
new Uri("http://fabrikam.com"));
}
Kommentarer
Värden för storeLocation ingår i StoreLocation uppräkningen:
LocalMachine: certifikatarkivet som tilldelats den lokala datorn.
CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).
Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.
Värden för storeName ingår i StoreName uppräkningen.
Gäller för
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)
Anger ett certifikat efter certifikatarkivplats, certifikatarkivets namn, typ av X.509-sökning och värde att söka efter och lagrar det i en samling som ska användas för den URL som anger omfånget.
public:
void SetScopedCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue, Uri ^ targetService);
public void SetScopedCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue, Uri targetService);
member this.SetScopedCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj * Uri -> unit
Public Sub SetScopedCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object, targetService As Uri)
Parametrar
- storeLocation
- StoreLocation
Platsen för certifikatarkivet som tjänsten använder för att hämta tjänstcertifikatet.
- storeName
- StoreName
Namnet på X.509-certifikatarkivet som ska öppnas.
- findType
- X509FindType
Typen av X.509-sökning som ska köras.
- findValue
- Object
Värdet att söka efter i X.509-certifikatarkivet.
- targetService
- Uri
Den URL som anger omfånget.
Undantag
findValue eller targetService är null.
Försökte ange när autentiseringsuppgifterna är skrivskyddade.
Exempel
Den här koden visar hur du anropar den här metoden.
public void snippet20(CalculatorClient client)
{
X509CertificateRecipientClientCredential rcc = client.ClientCredentials.ServiceCertificate;
rcc.SetScopedCertificate(StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"FabrikamSTS",
new Uri("http://fabrikam.com/sts"));
}
rcc.SetScopedCertificate(StoreLocation.CurrentUser, _
StoreName.TrustedPeople, _
X509FindType.FindBySubjectName, _
"FabrikamSTS", _
New Uri("http://fabrikam.com/sts"))
Kommentarer
Värden för storeLocation ingår i StoreLocation uppräkningen:
LocalMachine: certifikatarkivet som tilldelats den lokala datorn.
CurrentUser: certifikatarkivet som används av den aktuella användaren (standard).
Om programmet körs under ett systemkonto finns certifikatet vanligtvis i LocalMachine. Om programmet körs under ett användarkonto finns certifikatet vanligtvis i CurrentUser.
Värden för storeName ingår i StoreName uppräkningen.
Värden för findType ingår i X509FindType uppräkningen.
Den vanligaste uppräkningen är FindBySubjectName, som gör en skiftlägeskänslig sökning på certifikatets ämnesnamn i det angivna arkivet. Detta kan vara en oprecis sökning. Om inga certifikat eller flera certifikat som matchar kriterierna hittas genereras ett InvalidOperationException .