X509CertificateRecipientClientCredential.SetScopedCertificate Método

Definición

Espacio de nombres:: System.ServiceModel.Security

Ensamblados:: System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Ensamblado:: System.ServiceModel.Primitives.dll

Ensamblado:: System.ServiceModel.dll

Paquete:: System.ServiceModel.Primitives v10.0.652802

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece un certificado de un almacén y lo almacena en una colección indizada por la dirección URL que establece el ámbito.

Sobrecargas

Nombre	Description
SetScopedCertificate(String, StoreLocation, StoreName, Uri)	Establece un certificado por nombre de firmante, ubicación del almacén de certificados y nombre del almacén de certificados, y lo almacena en una colección que se usará para la dirección URL que establece el ámbito.
SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)	Establece un certificado por ubicación del almacén de certificados, el nombre del almacén de certificados, el tipo de búsqueda X.509 y el valor que se va a buscar y los almacena en una colección que se usará para la dirección URL que establece el ámbito.

SetScopedCertificate(String, StoreLocation, StoreName, Uri)

Source:: X509CertificateRecipientClientCredential.cs

Source:: X509CertificateRecipientClientCredential.cs

Source:: X509CertificateRecipientClientCredential.cs

Establece un certificado por nombre de firmante, ubicación del almacén de certificados y nombre del almacén de certificados, y lo almacena en una colección que se usará para la dirección URL que establece el ámbito.

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)

Parámetros

subjectName: String

Nombre completo del firmante.

storeLocation: StoreLocation

Ubicación del almacén de certificados que usa el servicio para obtener el certificado de servicio.

storeName: StoreName

Nombre del almacén de certificados X.509 que se va a abrir.

targetService: Uri

Dirección URL que establece el ámbito.

Excepciones

ArgumentNullException

subjectName o targetService es null.

InvalidOperationException

Se intentó establecer cuando la credencial es de solo lectura.

Ejemplos

Este código muestra cómo llamar a este método.

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"));
}

Comentarios

Los valores de storeLocation se incluyen en la StoreLocation enumeración:

LocalMachine: almacén de certificados asignado al equipo local.
CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).

Si la aplicación se ejecuta en una cuenta del sistema, el certificado suele estar en LocalMachine. Si la aplicación se ejecuta en una cuenta de usuario, el certificado suele estar en CurrentUser.

Los valores de storeName se incluyen en la StoreName enumeración .

Se aplica a

SetScopedCertificate(StoreLocation, StoreName, X509FindType, Object, Uri)

Source:: X509CertificateRecipientClientCredential.cs

Source:: X509CertificateRecipientClientCredential.cs

Source:: X509CertificateRecipientClientCredential.cs

Establece un certificado por ubicación del almacén de certificados, el nombre del almacén de certificados, el tipo de búsqueda X.509 y el valor que se va a buscar y los almacena en una colección que se usará para la dirección URL que establece el ámbito.

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)

Parámetros

storeLocation: StoreLocation

Ubicación del almacén de certificados que usa el servicio para obtener el certificado de servicio.

storeName: StoreName

Nombre del almacén de certificados X.509 que se va a abrir.

findType: X509FindType

Tipo de búsqueda X.509 que se va a ejecutar.

findValue: Object

Valor que se va a buscar en el almacén de certificados X.509.

targetService: Uri

Dirección URL que establece el ámbito.

Excepciones

ArgumentNullException

findValue o targetService es null.

InvalidOperationException

Se intentó establecer cuando la credencial es de solo lectura.

Ejemplos

Este código muestra cómo llamar a este método.

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"))

Comentarios

Los valores de storeLocation se incluyen en la StoreLocation enumeración:

LocalMachine: almacén de certificados asignado al equipo local.
CurrentUser: el almacén de certificados usado por el usuario actual (valor predeterminado).

Si la aplicación se ejecuta en una cuenta del sistema, el certificado suele estar en LocalMachine. Si la aplicación se ejecuta en una cuenta de usuario, el certificado suele estar en CurrentUser.

Los valores de storeName se incluyen en la StoreName enumeración .

Los valores de findType se incluyen en la X509FindType enumeración .

La enumeración más usada es FindBySubjectName, que realiza una búsqueda sin distinción entre mayúsculas y minúsculas en el nombre del firmante de los certificados en el almacén especificado. Puede ser una búsqueda imprecisa. Si no se encuentran certificados o varios certificados que coincidan con los criterios, se producirá una InvalidOperationException excepción .

Se aplica a

Comentarios

¿Le ha resultado útil esta página?