ClusCryptoKeys.AddItem method
[The AddItem method is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Adds a crypto key to a ClusCryptoKeys collection.
Syntax
ClusCryptoKeys.AddItem( _
ByVal strName _
)
Parameters
-
strName
-
String identifying the cryptographic service provider (CSP) key container to be checkpointed. The CSP key container must first be created with the Cryptography API, and the keys in the container must be exportable. The string must specify the CSP provider type, provider name, and key container name using the following syntax.
Type\Name\Key
Note that the values must be separated by a '\'. The provider type should specify the decimal value of the type, not the constant that represents the value. For example, instead of "PROV_RSA_FULL" use "1". The provider name is optional, and if it is omitted, the default CSP provider name associated with the specified provider type will be used.
Return value
A string that receives the added key.
Remarks
For more information on the following points, see the Cryptography Reference.
- A key container is given a name when it is created using CryptAcquireContext with dwFlags set to CRYPT_NEWKEYSET.
- Once a key container has been created, the key pairs for that key container must be created using CryptGenKey with the dwFlags parameter set to CRYPT_EXPORTABLE. Note that some CSPs do not allow key exports from their key containers. If a key is not exportable then the ClusterResourceControl call will fail with an NTE_BAD_KEY error.
For more information on checkpoints, see Checkpointing.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Header |
|
| IDL |
|
| Type library |
|
| DLL |
|
| IID |
IID_ISClusCryptoKeys is defined as F2E6072C-2631-11D1-89F1-00A0C90D061E |