Edit

Share via

CMC_STATUS_INFO structure (wincrypt.h)

  • Article

The CMC_STATUS_INFO structure contains status information about Certificate Management Messages over CMS.

Syntax

typedef struct _CMC_STATUS_INFO {
  DWORD  dwStatus;
  DWORD  cBodyList;
  DWORD  *rgdwBodyList;
  LPWSTR pwszStatusString;
  DWORD  dwOtherInfoChoice;
  union {
    DWORD          dwFailInfo;
    PCMC_PEND_INFO pPendInfo;
  } DUMMYUNIONNAME;
} CMC_STATUS_INFO, *PCMC_STATUS_INFO;

Members

dwStatus

A DWORD value that indicates the status of the message.

Value Meaning
CMC_STATUS_SUCCESS
0
 Request was granted.
CMC_STATUS_FAILED
2
 Request failed. There is addition information in other parts of the message.
CMC_STATUS_PENDING
3
 Request body part has not been processed. Requester must poll again. This value is returned only on certificate requests.
CMC_STATUS_NO_SUPPORT
4
 Requested operation is not supported.
CMC_STATUS_CONFIRM_REQUIRED
5
 Confirmation by using the idConfirmCertAcceptance control is required before the certificate can be used.

cBodyList

A DWORD count of the elements in the rgdwBodyList array.

rgdwBodyList

A DWORD array.

pwszStatusString

Optional string text indicating message status.

dwOtherInfoChoice

A DWORD value that identifies the union member to be used.

This member can be one of the following values:

  • CMC_OTHER_INFO_NO_CHOICE
  • CMC_OTHER_INFO_FAIL_CHOICE
  • CMC_OTHER_INFO_PENDING_CHOICE

DUMMYUNIONNAME

DUMMYUNIONNAME.dwFailInfo

A DWORD member of the union. This member is used if dwOtherInfoChoice is CMC_OTHER_INFO_FAIL_CHOICE. The following values are returned for various failures.

Value Meaning
CMC_FAIL_BAD_ALG
0
 Unrecognized or unsupported algorithm.
CMC_FAIL_BAD_MESSAGE_CHECK
1
 Integrity check failed.
CMC_FAIL_BAD_REQUEST
2
 Transaction not permitted or supported.
CMC_FAIL_BAD_TIME
3
 Message time field was not sufficiently close to the system time.
CMC_FAIL_BAD_CERT_ID
4
 No certificate could be identified matching the provided criteria.
CMC_FAIL_UNSUPORTED_EXT
5
 Requested X.509 extension is not supported by the recipient CA.
CMC_FAIL_MUST_ARCHIVE_KEYS
6
 Private key material must be supplied.
CMC_FAIL_BAD_IDENTITY
7
 Identification attribute failed to verify.
CMC_FAIL_POP_REQUIRED
8
 Server requires a POP proof before issuing certificate.
CMC_FAIL_POP_FAILED
9
 POP processing failed.
CMC_FAIL_NO_KEY_REUSE
10
 Server policy does not allow key re-use.
CMC_FAIL_INTERNAL_CA_ERROR
11
 Certification authority (CA) had an internal failure.
CMC_FAIL_TRY_LATER
12
 Request failed for an unknown reason. The request should be reissued later.

DUMMYUNIONNAME.pPendInfo

A pointer to the CMC_PEND_INFO structure member of the union. This member is used if dwOtherInfoChoice is CMC_OTHER_INFO_PEND_CHOICE.

Remarks

Additional members of the union may be defined in future versions.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h