diff --git a/xml/System.Security.Cryptography/HMACMD5.xml b/xml/System.Security.Cryptography/HMACMD5.xml index dcc8b50051f..ed44eb8405b 100644 --- a/xml/System.Security.Cryptography/HMACMD5.xml +++ b/xml/System.Security.Cryptography/HMACMD5.xml @@ -567,7 +567,7 @@ The HMAC key. The data to HMAC. The buffer to receive the HMAC value. - When this method returns, the total number of bytes written into . + When this method returns, contains the total number of bytes written into . Attempts to compute the HMAC of data using the MD5 algorithm. if is too small to hold the calculated hash, otherwise. diff --git a/xml/System.Security.Cryptography/HMACSHA1.xml b/xml/System.Security.Cryptography/HMACSHA1.xml index 144fa13f74f..2e610c9a0c1 100644 --- a/xml/System.Security.Cryptography/HMACSHA1.xml +++ b/xml/System.Security.Cryptography/HMACSHA1.xml @@ -695,7 +695,7 @@ Releases the unmanaged resources used by the The HMAC key. The data to HMAC. The buffer to receive the HMAC value. - When this method returns, the total number of bytes written into . + When this method returns, contains the total number of bytes written into . Attempts to compute the HMAC of data using the SHA1 algorithm. if is too small to hold the calculated hash, otherwise. diff --git a/xml/System.Security.Cryptography/HMACSHA512.xml b/xml/System.Security.Cryptography/HMACSHA512.xml index 903dbe77587..b3b1bcc6f62 100644 --- a/xml/System.Security.Cryptography/HMACSHA512.xml +++ b/xml/System.Security.Cryptography/HMACSHA512.xml @@ -631,7 +631,7 @@ public static void Test() The HMAC key. The data to HMAC. The buffer to receive the HMAC value. - When this method returns, the total number of bytes written into . + When this method returns, contains the total number of bytes written into . Attempts to compute the HMAC of data using the SHA512 algorithm. if is too small to hold the calculated hash, otherwise. diff --git a/xml/System.Security.Cryptography/SymmetricAlgorithm.xml b/xml/System.Security.Cryptography/SymmetricAlgorithm.xml index 273655e269a..5b9af63cf55 100644 --- a/xml/System.Security.Cryptography/SymmetricAlgorithm.xml +++ b/xml/System.Security.Cryptography/SymmetricAlgorithm.xml @@ -644,12 +644,27 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data using CBC mode with the specified padding mode. + The decrypted plaintext data. + + . + + ]]> + + + or is . + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. @@ -678,12 +693,25 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data using CBC mode with the specified padding mode. + The decrypted plaintext data. + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. @@ -713,13 +741,27 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data into the specified buffer, using CBC mode with the specified padding mode. + The total number of bytes written to + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. + The buffer in is too small to hold the plaintext data. @@ -749,13 +791,36 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Decrypts data using CFB mode with the specified padding mode and feedback size. + The decrypted plaintext data. + + . + + ]]> + + + or is . + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -785,13 +850,34 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Decrypts data using CFB mode with the specified padding mode and feedback size. + The decrypted plaintext data. + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -822,14 +908,39 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Decrypts data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + The total number of bytes written to . + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + +-or- + +The buffer in is too small to hold the plaintext data. + The ciphertext could not be decrypted successfully. + +-or- + + is not valid for the algorithm. @@ -858,11 +969,24 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data using ECB mode with the specified padding mode. + The decrypted plaintext data. + + . + + ]]> + + + is . + + is not a valid padding mode. + The ciphertext could not be decrypted successfully. @@ -891,11 +1015,22 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data using ECB mode with the specified padding mode. + The decrypted plaintext data. + + . + + ]]> + + + is not a valid padding mode. + The ciphertext could not be decrypted successfully. @@ -925,12 +1060,24 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + Decrypts data into the specified buffer, using ECB mode with the specified padding mode. + The total number of bytes written to + + . + + ]]> + + + is not a valid padding mode. + The ciphertext could not be decrypted successfully. + The buffer in is too small to hold the plaintext data. @@ -1084,12 +1231,27 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data using CBC mode with the specified padding mode. + The encrypted ciphertext data. + + . + + ]]> + + + or is . + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. @@ -1118,12 +1280,25 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data using CBC mode with the specified padding mode. + The encrypted ciphertext data. + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. @@ -1153,13 +1328,27 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data into the specified buffer, using CBC mode with the specified padding mode. + The total number of bytes written to . + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. + The buffer in is too small to hold the ciphertext data. @@ -1189,13 +1378,36 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Encrypts data using CFB mode with the specified padding mode and feedback size. + The encrypted ciphertext data. + + . + + ]]> + + + or is . + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -1225,13 +1437,34 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Encrypts data using CFB mode with the specified padding mode and feedback size. + The encrypted ciphertext data. + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -1262,14 +1495,35 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Encrypts data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + The total number of bytes written to . + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -1298,11 +1552,24 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data using ECB mode with the specified padding mode. + The encrypted ciphertext data. + + . + + ]]> + + + is . + + is not a valid padding mode. + The plaintext could not be encrypted successfully. @@ -1331,11 +1598,22 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data using ECB mode with the specified padding mode. + The encrypted ciphertext data. + + . + + ]]> + + + is not a valid padding mode. + The plaintext could not be encrypted successfully. @@ -1365,12 +1643,24 @@ We recommend that you specify the algorithm by calling the - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + Encrypts data into the specified buffer, using ECB mode with the specified padding mode. + The total number of bytes written to . + + . + + ]]> + + + is not a valid padding mode. + The plaintext could not be encrypted successfully. + The buffer in is too small to hold the ciphertext data. @@ -1619,19 +1909,19 @@ Allows an to attempt to free resources and perfor is a negative number. -- or - - - when padded is too large to represent as a signed 32-bit integer. +-or- + + when padded is too large to represent as a signed 32-bit integer. + +-or- -- or - - - is not a valid padding mode. + is not a valid padding mode. is not a positive integer. -- or - - - is not a whole number of bytes. It must be divisible by 8. +-or- + + is not a whole number of bytes. It must be divisible by 8. The padding mode was used, but is not a whole number of blocks. @@ -1679,22 +1969,22 @@ Allows an to attempt to free resources and perfor is not a positive number. -- or - - - is a negative number. +-or- + + is a negative number. + +-or- -- or - - - when padded is too large to represent as a signed 32-bit integer. + when padded is too large to represent as a signed 32-bit integer. -- or - +-or- - is not a valid padding mode. + is not a valid padding mode. The padding mode was used, but is not a whole number of blocks. -- or - +-or- - is not a whole number of bytes. It must be divisible by 8. + is not a whole number of bytes. It must be divisible by 8. @@ -1731,19 +2021,19 @@ Allows an to attempt to free resources and perfor is a negative number. -- or - +-or- - when padded is too large to represent as a signed 32-bit integer. + when padded is too large to represent as a signed 32-bit integer. -- or - +-or- - is not a valid padding mode. + is not a valid padding mode. is not a positive integer. -- or - +-or- - is not a whole number of bytes. It must be divisible by 8. + is not a whole number of bytes. It must be divisible by 8. The padding mode was used, but is not a whole number of blocks. @@ -2510,14 +2800,28 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + When this method returns, contains the total number of bytes written to . + The padding mode used to produce the ciphertext and remove during decryption. + Attempts to decrypt data into the specified buffer, using CBC mode with the specified padding mode. + + if was large enough to receive the decrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. @@ -2549,14 +2853,24 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to decrypt data into the specified buffer, using CBC mode with the specified padding mode. + + if was large enough to receive the decrypted data; otherwise, . + + + + A derived class has not provided an implementation. @@ -2588,15 +2902,37 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + When this method returns, contains the total number of bytes written to . + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Attempts to decrypt data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + + if was large enough to receive the decrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The ciphertext could not be decrypted successfully. + +-or- + + is not valid for the algorithm. @@ -2629,15 +2965,25 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The initialization vector. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to decrypt data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + + if was large enough to receive the decrypted data; otherwise, . + + + + A derived class has not provided an implementation. @@ -2668,13 +3014,25 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + Attempts to decrypt data into the specified buffer, using ECB mode with the specified padding mode. + + if was large enough to receive the decrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + The ciphertext could not be decrypted successfully. @@ -2705,13 +3063,23 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to decrypt. + The buffer to receive the plaintext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to decrypt data into the specified buffer, using ECB mode with the specified padding mode. + + if was large enough to receive the decrypted data; otherwise, . + + + + A derived class has not provided an implementation. @@ -2742,14 +3110,28 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + When this method returns, contains the total number of bytes written to . + The padding mode used to produce the ciphertext and remove during decryption. + Attempts to encrypt data into the specified buffer, using CBC mode with the specified padding mode. + + if was large enough to receive the encrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. @@ -2781,14 +3163,32 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to encrypt data into the specified buffer, using CBC mode with the specified padding mode. + + if was large enough to receive the encrypted data; otherwise, . + + + + A derived class has not provided an implementation. @@ -2820,15 +3220,37 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + When this method returns, contains the total number of bytes written to . + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + Attempts to encrypt data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + + if was large enough to receive the encrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + +-or- + + is not positive or represent a whole number of bytes. + + is the incorrect length. Callers are expected to pass an initialization vector that is exactly in length, converted to bytes (BlockSize / 8). + The plaintext could not be encrypted successfully. + +-or- + +The feedback size is not valid for the algorithm. @@ -2861,15 +3283,33 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The initialization vector. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + The feedback size, specified in bits. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to encrypt data into the specified buffer, using CFB mode with the specified padding mode and feedback size. + + if was large enough to receive the encrypted data; otherwise, . + + + + A derived class has not provided an implementation. @@ -2900,13 +3340,25 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + Attempts to encrypt data into the specified buffer, using ECB mode with the specified padding mode. + + if was large enough to receive the encrypted data; otherwise, . + + . + + ]]> + + + is not a valid padding mode. + The plaintext could not be encrypted successfully. @@ -2937,13 +3389,31 @@ This member is an explicit interface member implementation. It can be used only - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. - To be added. + The data to encrypt. + The buffer to receive the ciphertext data. + The padding mode used to produce the ciphertext and remove during decryption. + When this method returns, contains the total number of bytes written to . + When overridden in a derived class, attempts to encrypt data into the specified buffer, using ECB mode with the specified padding mode. + + if was large enough to receive the encrypted data; otherwise, . + + + + A derived class has not provided an implementation.