Export (0) Print
Expand All
Expand Minimize

IEnroll4::acceptPKCS7Blob method

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The acceptPKCS7Blob method accepts and processes a PKCS #7 message containing a certificate. The PKCS #7 is input as a parameter. This method was first defined in the IEnroll interface.

Syntax


HRESULT acceptPKCS7Blob(
  [in]  PCRYPT_DATA_BLOB pBlobPKCS7
);

Parameters

pBlobPKCS7 [in]

Represents the base64-encoded PKCS #7 containing the certificate and the chain of certificates identifying the issuer.

Return value

The return value is an HRESULT. A value of S_OK indicates success. Upon successful completion of this function, the PKCS #7 will be accepted.

Remarks

The PKCS #7 input as a parameter for acceptPKCS7Blob contains the request certificate and the chain of certificates identifying the issuer of the certificate. Typically, but not always, the chain of certificates does not include the root. The PKCS #7 can be in base64-encoded, binary, or X.509 certificate format (with or without the "begin cert" and "end cert" tags). The certificate and the associated keys generated for it are put in the MY store. A root certificate is placed in the ROOT store, and the rest of the chain of certificates is placed in the certification authority (CA) store. If any ROOT certificates found in the PKCS #7 are accepted, Crypt32 will notify the user that a ROOT certificate is being added to the user's store. The user has the option of declining the ROOT certificate. This option is provided so that the user can decline to place an untrusted root in the ROOT store. Declining to place the ROOT in the ROOT store will not cause Certificate Enrollment Control to fail acceptance.

By default, the MY, CA, ROOT, and REQUEST system stores are used to store the certificates. However, you can specify other stores by assigning the following properties before calling this method:

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_IEnroll4 is defined as f8053fe5-78f4-448f-a0db-41d61b73446b

See also

IEnroll4

 

 

Community Additions

ADD
Show:
© 2014 Microsoft