IChannelCredentials Schnittstelle

Referenz

Definition

Namespace:: System.ServiceModel.ComIntegration

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine Schnittstelle, die die Einstellung bestimmter Sicherheitsfunktionen für einen Dienstproxy ermöglicht.

public interface class IChannelCredentials

[System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)]
public interface IChannelCredentials

[<System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)>]
type IChannelCredentials = interface

Public Interface IChannelCredentials

Attribute: GuidAttribute InterfaceTypeAttribute

Beispiele

monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
    monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
    monString = monString + ", binding=BasicHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  

    Set monikerProxy = GetObject(monString)  

    'Set the Service Certificate.  
    monikerProxy.ChannelCredentials.SetServiceCertificateAuthentication "CurrentUser", "NoCheck", "PeerOrChainTrust"  
    monikerProxy.ChannelCredentials.SetDefaultServiceCertificateFromStore "CurrentUser", "TrustedPeople", "FindBySubjectName", "localhost"  

    'Set the Client Certificate.  
    monikerProxy.ChannelCredentials.SetClientCertificateFromStoreByName "CN=client.com", "CurrentUser", "My"  
    MsgBox monikerProxy.Add(3, 4)

Hinweise

Nicht verwaltete Clients verwenden den Moniker "Service", um auf Windows Communication Foundation (WCF)-Dienste zuzugreifen. Diese Clients unterliegen dem WCF-Sicherheitsmodell und nicht dem com-Sicherheitsmodell. Die IChannelCredentials-Schnittstelle wird bereitgestellt, um Kanalanmeldeinformationen anzugeben. Dies ist erforderlich, da der com-Moniker nicht auf das verwaltete WCF-Sicherheits Objektmodell zugreifen kann.

Es ist nicht zulässig, Methoden für die IChannelCredentials-Schnittstelle aufzurufen, nachdem der Kanal erstellt wurde. Dies liegt daran, dass Windows Communication Foundation (WCF) das Ändern von Sicherheitseinstellungen auf einem bereits geöffneten Kanal nicht unterstützt. Wenn der Dienstmonikerclient einen Proxy erhält, ist der Kanal noch nicht erstellt. Daher muss der Client vor dem Aufrufen der Dienstmethode IChannelCredentials-Methoden aufrufen. Wenn der Client eine IChannelCredentials-Methode aufruft, nachdem die Dienstmethode aufgerufen wurde, wird die Ausnahme RPC_E_TOO_LATE ausgelöst.

Methoden

SetClientCertificateFromFile(String, String, String)	Ruft ein Zertifikat von einer Datei ab und fügt es den Client-Anmeldeinformationen hinzu.
SetClientCertificateFromStore(String, String, String, Object)	Ruft ein Zertifikat von einem Zertifikatsspeicher ab und fügt es den Client-Anmeldeinformationen hinzu.
SetClientCertificateFromStoreByName(String, String, String)	Ruft ein Zertifikat von einem Zertifikatsspeicher über den Namen ab und fügt es den Client-Anmeldeinformationen hinzu.
SetDefaultServiceCertificateFromFile(String, String, String)	Ruft ein Zertifikat von einer Datei ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.
SetDefaultServiceCertificateFromStore(String, String, String, Object)	Ruft ein Zertifikat von einem Zertifikatsspeicher ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.
SetDefaultServiceCertificateFromStoreByName(String, String, String)	Ruft ein Zertifikat von einem Zertifikatsspeicher über den Namen ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.
SetIssuedToken(String, String, String)	Legt Parameter für das ausgegebene Token fest.
SetServiceCertificateAuthentication(String, String, String)	Legt die Dienstzertifikatsauthentifizierungsparameter fest.
SetUserNameCredential(String, String)	Legt die Benutzernamenanmeldeinformationen fest.
SetWindowsCredential(String, String, String, Int32, Boolean)	Legt die Windows-Anmeldeinformationen fest.

Gilt für

Freigeben über