estrutura CRYPTUI_WIZ_DIGITAL_SIGN_INFO (cryptuiapi.h)

[A estrutura CRYPTUI_WIZ_DIGITAL_SIGN_INFO está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A estrutura CRYPTUI_WIZ_DIGITAL_SIGN_INFO contém informações sobre assinatura digital. Essa estrutura é usada pela função CryptUIWizDigitalSign .

Sintaxe

typedef struct _CRYPTUI_WIZ_DIGITAL_SIGN_INFO {
  DWORD                                    dwSize;
  DWORD                                    dwSubjectChoice;
  union {
    LPCWSTR                              pwszFileName;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO pSignBlobInfo;
  };
  DWORD                                    dwSigningCertChoice;
  union {
    PCCERT_CONTEXT                           pSigningCertContext;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO    pSigningCertStore;
    PCCRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO pSigningCertPvkInfo;
  };
  LPCWSTR                                  pwszTimestampURL;
  DWORD                                    dwAdditionalCertChoice;
  PCCRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO pSignExtInfo;
} CRYPTUI_WIZ_DIGITAL_SIGN_INFO, *PCRYPTUI_WIZ_DIGITAL_SIGN_INFO;

Membros

dwSize

Especifica o tamanho, em bytes, da estrutura.

dwSubjectChoice

Um valor que indica a entidade que deve ser assinada. Esse membro será necessário se CRYPTUI_WIZ_NO_UI for especificado no parâmetro dwFlags da função CryptUIWizDigitalSign . Esse pode ser um dos valores a seguir.

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB	O BLOB de memória especificado pelo membro pSignBlobInfo deve ser assinado.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE	O arquivo especificado pelo membro pwszFileName deve ser assinado.
0	O usuário será solicitado a assinar um arquivo.

pwszFileName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho e o nome do arquivo a ser assinado. Esse membro será usado se CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE for especificado para o membro dwSubjectChoice .

pSignBlobInfo

Um ponteiro para uma estrutura CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO que contém o BLOB a ser assinado. Esse membro será usado se CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB for especificado para o membro dwSubjectChoice .

dwSigningCertChoice

Um valor que especifica o local do certificado usado para assinar a entidade. O valor padrão é zero. Esse pode ser um dos valores a seguir.

Nota Se CRYPTUI_WIZ_NO_UI for especificado no parâmetro dwFlags da função CryptUIWizDigitalSign , esse valor deverá ser CRYPTUI_WIZ_DIGITAL_SIGN_CERT ou CRYPTUI_WIZ_DIGITAL_SIGN_PVK.

 

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_CERT	O certificado está contido na estrutura CERT_CONTEXT apontada pelo membro pSigningCertContext .
CRYPTUI_WIZ_DIGITAL_SIGN_STORE	O certificado está contido no repositório de certificados contido na estrutura CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO apontada pelo membro pSigningCertStore .
CRYPTUI_WIZ_DIGITAL_SIGN_PVK	O certificado está contido no arquivo PVK contido na estrutura CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO apontada pelo membro pSigningCertPvkInfo .
0	Os certificados no Meu repositório são usados.

pSigningCertContext

Um ponteiro para uma estrutura CERT_CONTEXT que contém o certificado a ser usado para assinar a entidade. Esse membro será usado se CRYPTUI_WIZ_DIGITAL_SIGN_CERT for especificado para o membro dwSigningCertChoice .

pSigningCertStore

Um ponteiro para uma estrutura CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO que contém o certificado a ser usado para assinar a entidade. Esse membro será usado se CRYPTUI_WIZ_DIGITAL_SIGN_STORE for especificado para o membro dwSigningCertChoice .

pSigningCertPvkInfo

Um ponteiro para uma estrutura CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO que contém o certificado a ser usado para assinar a entidade. Esse membro será usado se CRYPTUI_WIZ_DIGITAL_SIGN_PVK for especificado para o membro dwSigningCertChoice .

pwszTimestampURL

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a URL do carimbo de data/hora.

dwAdditionalCertChoice

Um valor que indica se certificados adicionais serão incluídos na assinatura. O valor padrão é zero. Esse pode ser um dos valores a seguir.

Valor	Significado
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN	Toda a cadeia de certificados será incluída na assinatura.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT	Todos os certificados na cadeia de certificados, exceto a raiz, serão incluídos na assinatura.
0	Nenhum certificado adicional será incluído na assinatura.

pSignExtInfo

Um ponteiro para uma estrutura CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO que contém informações estendidas sobre a assinatura.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	cryptuiapi.h

Confira também

CryptUIWizDigitalSign