X509CertificateRecipientClientCredential.SetDefaultCertificate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サービスに使用する既定の証明書を指定します。
オーバーロード
| 名前 | 説明 |
|---|---|
| SetDefaultCertificate(String, StoreLocation, StoreName) |
サービスに使用する既定の証明書を指定します。 証明書ベースのメッセージ セキュリティを使用するバインドの場合、この証明書はサービスへのメッセージの暗号化に使用され、クライアントへの応答に署名するためにサービスによって使用されることが期待されます。 |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
サービスに使用する既定の証明書を指定します。 証明書ベースのメッセージ セキュリティを使用するバインドの場合、この証明書はサービスへのメッセージの暗号化に使用され、クライアントへの応答に署名するためにサービスによって使用されることが期待されます。 |
注釈
これらのメソッドは、指定されたパラメーターと一致する指定した場所にあるストアから証明書を取得します。
証明書ベースのメッセージ セキュリティを使用するバインドの場合、この証明書はサービスへのメッセージの暗号化に使用され、クライアントへの応答に署名するためにサービスによって使用されることが期待されます。
SetDefaultCertificate(String, StoreLocation, StoreName)
サービスに使用する既定の証明書を指定します。 証明書ベースのメッセージ セキュリティを使用するバインドの場合、この証明書はサービスへのメッセージの暗号化に使用され、クライアントへの応答に署名するためにサービスによって使用されることが期待されます。
public:
void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);public void SetDefaultCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unitPublic Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)パラメーター
- subjectName
- String
サブジェクト識別名。
- storeLocation
- StoreLocation
サービス証明書を取得するためにサービスが使用する証明書ストアの場所。
- storeName
- StoreName
開く X.509 証明書ストアの名前。
例外
subjectName は nullです。
資格情報が読み取り専用のときに設定しようとしました。
例
次のコードでは、このメソッドを使用して、使用する X.509 証明書を指定します。
public void snippet23(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate("http://fabrikam.com/sts",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
}
注釈
このメソッドは、 subjectName パラメーターと一致する指定した場所にあるストアから証明書を取得します。
storeLocationの値は、StoreLocation列挙型に含まれます。
LocalMachine: ローカル コンピューターに割り当てられた証明書ストア。
CurrentUser: 現在のユーザーによって使用される証明書ストア (既定値)。
アプリケーションがシステム アカウントで実行されている場合、証明書は通常 LocalMachine。 アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 CurrentUser。
storeNameの値は、StoreName列挙型に含まれます。
適用対象
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)
サービスに使用する既定の証明書を指定します。 証明書ベースのメッセージ セキュリティを使用するバインドの場合、この証明書はサービスへのメッセージの暗号化に使用され、クライアントへの応答に署名するためにサービスによって使用されることが期待されます。
public:
void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);public void SetDefaultCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unitPublic Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)パラメーター
- storeLocation
- StoreLocation
サービス証明書を取得するためにサービスが使用する証明書ストアの場所。
- storeName
- StoreName
開く X.509 証明書ストアの名前。
- findType
- X509FindType
実行する X.509 検索の種類。
- findValue
- Object
X.509 証明書ストアで検索する値。
例外
findValue は nullです。
資格情報が読み取り専用のときに設定しようとしました。
例
次のコードでは、このメソッドを使用して、使用する X.509 証明書を指定します。
public void snippet22(CalculatorClient cc)
{
X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"FabrikamSTS");
}
注釈
このメソッドは、 findType パラメーターと findValue パラメーターに一致する指定した場所にあるストアから証明書を取得します。
storeLocationの値は、StoreLocation列挙型に含まれます。
LocalMachine: ローカル コンピューターに割り当てられた証明書ストア。
CurrentUser: 現在のユーザーによって使用される証明書ストア (既定値)。
アプリケーションがシステム アカウントで実行されている場合、証明書は通常 LocalMachine。 アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 CurrentUser。
storeNameの値は、StoreName列挙型に含まれます。
findTypeの値は、X509FindType列挙型に含まれます。
最も一般的に使用される列挙体は FindBySubjectNameであり、指定したストア内の証明書のサブジェクト名に対して大文字と小文字を区別しない検索を行います。 これは不正確な検索である可能性があります。 条件に一致する証明書または複数の証明書が見つからない場合は、 InvalidOperationException がスローされます。
