Skip to content

Latest commit

 

History

History
161 lines (115 loc) · 6.23 KB

nf-certenroll-ix509certificaterequest-put_alternatesignaturealgorithm.md

File metadata and controls

161 lines (115 loc) · 6.23 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:certenroll.IX509CertificateRequest.put_AlternateSignatureAlgorithm
IX509CertificateRequest::put_AlternateSignatureAlgorithm (certenroll.h)
Specifies and retrieves a Boolean value that indicates whether the signature algorithm object identifier (OID) for a PKCS (Put)
AlternateSignatureAlgorithm property [Security]
AlternateSignatureAlgorithm property [Security]
IX509CertificateRequest interface
IX509CertificateRequest interface [Security]
AlternateSignatureAlgorithm property
IX509CertificateRequest.AlternateSignatureAlgorithm
IX509CertificateRequest.put_AlternateSignatureAlgorithm
IX509CertificateRequest::AlternateSignatureAlgorithm
IX509CertificateRequest::get_AlternateSignatureAlgorithm
IX509CertificateRequest::put_AlternateSignatureAlgorithm
certenroll/IX509CertificateRequest::AlternateSignatureAlgorithm
certenroll/IX509CertificateRequest::get_AlternateSignatureAlgorithm
certenroll/IX509CertificateRequest::put_AlternateSignatureAlgorithm
put_AlternateSignatureAlgorithm
security.ix509certificaterequest_alternatesignaturealgorithm_property
security\ix509certificaterequest_alternatesignaturealgorithm_property.htm
security
57a87aab-1e53-4b0b-a7b9-2fe89083819b
12/05/2018
AlternateSignatureAlgorithm property [Security], AlternateSignatureAlgorithm property [Security],IX509CertificateRequest interface, IX509CertificateRequest interface [Security],AlternateSignatureAlgorithm property, IX509CertificateRequest.AlternateSignatureAlgorithm, IX509CertificateRequest.put_AlternateSignatureAlgorithm, IX509CertificateRequest::AlternateSignatureAlgorithm, IX509CertificateRequest::get_AlternateSignatureAlgorithm, IX509CertificateRequest::put_AlternateSignatureAlgorithm, certenroll/IX509CertificateRequest::AlternateSignatureAlgorithm, certenroll/IX509CertificateRequest::get_AlternateSignatureAlgorithm, certenroll/IX509CertificateRequest::put_AlternateSignatureAlgorithm, put_AlternateSignatureAlgorithm, security.ix509certificaterequest_alternatesignaturealgorithm_property
certenroll.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
CertEnroll.dll
Windows
19H1
IX509CertificateRequest::put_AlternateSignatureAlgorithm
certenroll/IX509CertificateRequest::put_AlternateSignatureAlgorithm
c++
APIRef
kbSyntax
COM
CertEnroll.dll
IX509CertificateRequest.AlternateSignatureAlgorithm
IX509CertificateRequest.get_AlternateSignatureAlgorithm
IX509CertificateRequest.put_AlternateSignatureAlgorithm

IX509CertificateRequest::put_AlternateSignatureAlgorithm

-description

The AlternateSignatureAlgorithm property specifies and retrieves a Boolean value that indicates whether the signature algorithm object identifier (OID) for a PKCS #10 request or certificate signature is discrete or combined. A PKCS #10 object can be a stand-alone request or it can be contained in a CMC or PKCS #7 request object.

This property is read/write.

-parameters

-remarks

Discrete algorithms are represented by separate object identifiers (OIDs) for the hashing algorithm and the signing algorithm. Examples include the following values.

Discrete algorithm OID Description
XCN_OID_NIST_sha256

(2.16.840.1.101.3.4.2.1)

National Institute of Standards and Technologies (NIST) 256-bit SHA hashing algorithm.
XCN_OID_OIWSEC_rsaSign

(1.3.14.3.2.11)

NIST OSE Implementer Workshop Security (OIWSEC) RSA signing algorithm.
 

Combined algorithms are represented by a single OID that identifies both the hashing and the signing algorithm. Examples include the following values.

Combined algorithm OID Description
XCN_OID_RSA_MD2RSA

(1.2.840.113549.1.1.2)

MD2 hashing algorithm combined with the RSA encryption algorithm from RSA Laboratories.
XCN_OID_OIWSEC_md5RSA

(1.3.14.3.2.3)

OIWSEC MD5 hashing algorithm combined with the RSA encryption algorithm.
 

If the certificate request contains nested requests and you set the AlternateSignatureAlgorithm property on the top level request, it is automatically propagated to all of the inner requests. You can, however, set the property manually on each of the inner objects.

For a PKCS #7 or a CMC request, this property retrieves a Boolean value for the primary signature on the inner PKCS #10 request. On input, all signer certificates are updated with the specified property value.

For a PKCS #10 request or certificate signature using the RSA public key algorithm, a property value of False (which indicates a combined OID) implies a version 1.5 signature and True (discrete OID) implies a version 2.1 signature.

You must initialize the request object before calling this property. You can call this property before calling the Encode method.

-see-also

IX509CertificateRequest

IX509CertificateRequestCertificate

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10

IX509CertificateRequestPkcs7

IX509SignatureInformation