SIGNER_CERT structure

  • Article

The SIGNER_CERT structure specifies a certificate used to sign a document. The certificate can be stored in a Software Publisher Certificate (SPC) file or in a certificate store.

Note

This structure is not defined in any header file. To use this structure, you must define it yourself as shown in this topic.

 

Syntax

typedef struct _SIGNER_CERT {
  DWORD cbSize;
  DWORD dwCertChoice;
  union {
    LPCWSTR                pwszSpcFile;
    SIGNER_CERT_STORE_INFO *pCertStoreInfo;
    SIGNER_SPC_CHAIN_INFO  *pSpcChainInfo;
  };
  HWND  hwnd;
} SIGNER_CERT, *PSIGNER_CERT;

Members

cbSize

The size, in bytes, of the structure.

dwCertChoice

Specifies how the certificate is stored. This member can be one or more of the following values.

Value Meaning
SIGNER_CERT_SPC_FILE
1
 The certificate is stored in an SPC file. The pwszSpcFile member contains the path and file name of the SPC file.
SIGNER_CERT_STORE
2
 The certificate is stored in a certificate store. The pCertStoreInfo member contains a pointer to a SIGNER_CERT_STORE_INFO structure that specifies the certificate store in which the certificate is stored.
SIGNER_CERT_SPC_CHAIN
3
 The certificate is stored in an SPC file and is associated with a certificate chain. The pSpcChainInfo member contains a pointer to a SIGNER_SPC_CHAIN_INFO structure that contains the chain information for the certificate.

 

pwszSpcFile

A pointer to a null-terminated Unicode string that contains the path and file name of the SPC file in which the certificate is stored. This member is only used if the dwCertChoice member contains SIGNER_CERT_SPC_FILE.

pCertStoreInfo

A pointer to a SIGNER_CERT_STORE_INFO structure that specifies the certificate store in which the certificate is stored. This member is only used if the dwCertChoice member contains SIGNER_CERT_STORE.

pSpcChainInfo

A pointer to a SIGNER_SPC_CHAIN_INFO structure that contains the chain information for the certificate. This member is only used if the dwCertChoice member contains SIGNER_CERT_SPC_CHAIN.

hwnd

The handle of the window to use as the owner of any dialog boxes that are displayed. This member is not currently used and is ignored.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]

See also

SignerSign

SignerSignEx