diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12KeyBag.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12KeyBag.xml index cc037f0ebdd..50d715de244 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs12KeyBag.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12KeyBag.xml @@ -15,7 +15,7 @@ - To be added. + Represents the KeyBag from PKCS#12, a container whose contents are a PKCS#8 PrivateKeyInfo. This class cannot be inherited. To be added. @@ -36,10 +36,29 @@ - To be added. - To be added. - To be added. - To be added. + A BER-encoded PKCS#8 PrivateKeyInfo value. + to store without making a defensive copy; otherwise, . The default is . + Initializes a new instance of the from an existing encoded PKCS#8 PrivateKeyInfo value. + + ). + +The default behavior of this method is to make a defensive copy of `pkcs8PrivateKey`. +When the `skipCopy` parameter is `true`, this defensive copy is skipped. +If the defensive copy is skipped and the contents of `pkcs8PrivateKey` change during the lifetime of the returned value or of any object produced by its +methods or properties, then methods and properties on those objects may produce nonsense results or throw exceptions due to the corrupted state. +Callers are therefore advised to only use a `true` value for the `skipCopy` parameter when they can be reasonably assured that the data will stay intact. + + ]]> + + The parameter does not represent a single ASN.1 BER-encoded value. + @@ -59,10 +78,20 @@ System.ReadOnlyMemory<System.Byte> - To be added. - To be added. - To be added. + Gets a memory value containing the PKCS#8 PrivateKeyInfo value transported by this bag. + A memory value containing the PKCS#8 PrivateKeyInfo value transported by this bag. + + property. + + ]]> + - \ No newline at end of file + diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12SafeContentsBag.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12SafeContentsBag.xml index 87a37b4d024..70fa3dd6f2c 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs12SafeContentsBag.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12SafeContentsBag.xml @@ -15,8 +15,9 @@ - To be added. + Represents the SafeContentsBag from PKCS#12, a container whose contents are a PKCS#12 SafeContents value. This class cannot be inherited. To be added. + @@ -36,10 +37,10 @@ System.Security.Cryptography.Pkcs.Pkcs12SafeContents - To be added. - To be added. + Gets the SafeContents value contained within this bag. + The SafeContents value contained within this bag. To be added. - \ No newline at end of file + diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12SecretBag.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12SecretBag.xml index bf3f6d98d00..0a8308c8d31 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs12SecretBag.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12SecretBag.xml @@ -15,7 +15,7 @@ - To be added. + Represents the SecretBag from PKCS#12, a container whose contents are arbitrary data with a type identifier. This class cannot be inherited. To be added. @@ -37,9 +37,10 @@ - To be added. - To be added. + Gets the Object Identifier (OID) which identifies the data type of the secret value. + The Object Identifier (OID) which identifies the data type of the secret value. To be added. + @@ -59,10 +60,11 @@ System.ReadOnlyMemory<System.Byte> - To be added. - To be added. + Gets a memory value containing the BER-encoded contents of the bag. + A memory value containing the BER-encoded contents of the bag. To be added. + - \ No newline at end of file + diff --git a/xml/System.Security.Cryptography.Pkcs/Pkcs12ShroudedKeyBag.xml b/xml/System.Security.Cryptography.Pkcs/Pkcs12ShroudedKeyBag.xml index 647e1b57fc1..3cb0cddd40c 100644 --- a/xml/System.Security.Cryptography.Pkcs/Pkcs12ShroudedKeyBag.xml +++ b/xml/System.Security.Cryptography.Pkcs/Pkcs12ShroudedKeyBag.xml @@ -15,7 +15,7 @@ - To be added. + Represents the ShroudedKeyBag from PKCS#12, a container whose contents are a PKCS#8 EncryptedPrivateKeyInfo. This class cannot be inherited. To be added. @@ -36,10 +36,26 @@ - To be added. - To be added. - To be added. - To be added. + A BER-encoded PKCS#8 EncryptedPrivateKeyInfo value. + to store without making a defensive copy; otherwise, . The default is . + Initializes a new instance of the from an existing encoded PKCS#8 EncryptedPrivateKeyInfo value. + + + + The parameter does not represent a single ASN.1 BER-encoded value. + @@ -59,10 +75,20 @@ System.ReadOnlyMemory<System.Byte> - To be added. - To be added. - To be added. + Gets a memory value containing the PKCS#8 EncryptedPrivateKeyInfo value transported by this bag. + A memory value containing the PKCS#8 EncryptedPrivateKeyInfo value transported by this bag. + + property. + + ]]> + - \ No newline at end of file +