ICspAlgorithm::get_Valid method (certenroll.h)

The Valid property retrieves a Boolean value that specifies whether the algorithm object is valid.

This property is read-only.

Syntax

HRESULT get_Valid(
  VARIANT_BOOL *pValue
);

Parameters

pValue

Return value

None

Remarks

If a template refers to an algorithm that is not supported by the specified cryptographic provider, the enrollment process creates a placeholder ICspAlgorithm object, sets the Valid property to false, and sets the Name property. No other property values are defined.

You must call the InitializeFromName method or the InitializeFromType method on the ICspInformation interface before calling this property.

Abstract Syntax Notation One (ASN.1) is defined by the X.680 through X.683 standards. The Certificate Enrollment API verifies an object identifier (OID) by Distinguished Encoding Rules (DER) encoding it and then decoding the result to make certain that the OID remains unchanged and by checking that the following are true:

  • The first number in the OID is either 0, 1, or 2.
  • All other characters are either digits (0 to 9) or periods (.).
  • No periods start or end the OID.
  • No consecutive characters are both periods.
  • The OID must contain at least one period.
  • If the first number is 0 or 1, the second number must be between 0 and 39 inclusive.
  • If the first number is 2, the second number can be any value.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

ICspAlgorithm