CRYPTUI_WIZ_DIGITAL_SIGN_INFO 구조체(cryptuiapi.h)

[ CRYPTUI_WIZ_DIGITAL_SIGN_INFO 구조는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

CRYPTUI_WIZ_DIGITAL_SIGN_INFO 구조에는 디지털 서명에 대한 정보가 포함되어 있습니다. 이 구조체는 CryptUIWizDigitalSign 함수에서 사용됩니다.

구문

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;

멤버

dwSize

구조체의 크기(바이트)입니다.

dwSubjectChoice

서명할 엔터티를 나타내는 값입니다. CryptUIWizDigitalSign 함수의 dwFlags 매개 변수에 CRYPTUI_WIZ_NO_UI 지정하는 경우 이 멤버가 필요합니다. 다음 값 중 하나일 수 있습니다.

값	의미
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB	pSignBlobInfo 멤버에 의해 지정된 메모리 BLOB에 서명됩니다.
CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE	pwszFileName 멤버가 지정한 파일에 서명해야 합니다.
0	사용자에게 서명할 파일을 묻는 메시지가 표시됩니다.

pwszFileName

서명할 파일의 경로 및 파일 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 멤버는 dwSubjectChoice 멤버에 대해 CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_FILE 지정한 경우에 사용됩니다.

pSignBlobInfo

서명할 BLOB을 포함하는 CRYPTUI_WIZ_DIGITAL_SIGN_BLOB_INFO 구조체에 대한 포인터입니다. 이 멤버는 dwSubjectChoice 멤버에 대해 CRYPTUI_WIZ_DIGITAL_SIGN_SUBJECT_BLOB 지정된 경우에 사용됩니다.

dwSigningCertChoice

엔터티에 서명하는 데 사용되는 인증서의 위치를 지정하는 값입니다. 기본값은 영입니다. 다음 값 중 하나일 수 있습니다.

참고CryptUIWizDigitalSign 함수의 dwFlags 매개 변수에 CRYPTUI_WIZ_NO_UI 지정된 경우 이 값은 CRYPTUI_WIZ_DIGITAL_SIGN_CERT 또는 CRYPTUI_WIZ_DIGITAL_SIGN_PVK 합니다.

 

값	의미
CRYPTUI_WIZ_DIGITAL_SIGN_CERT	인증서는 pSigningCertContext 멤버가 가리키는 CERT_CONTEXT 구조에 포함되어 있습니다.
CRYPTUI_WIZ_DIGITAL_SIGN_STORE	인증서는 pSigningCertStore 멤버가 가리키는 CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO 구조에 포함된 인증서 저장소에 포함됩니다.
CRYPTUI_WIZ_DIGITAL_SIGN_PVK	인증서는 pSigningCertPvkInfo 멤버가 가리키는 CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO 구조에 포함된 PVK 파일에 포함되어 있습니다.
0	내 저장소의 인증서가 사용됩니다.

pSigningCertContext

엔터티에 서명하는 데 사용할 인증서를 포함하는 CERT_CONTEXT 구조체에 대한 포인터입니다. 이 멤버는 dwSigningCertChoice 멤버에 대해 CRYPTUI_WIZ_DIGITAL_SIGN_CERT 지정한 경우에 사용됩니다.

pSigningCertStore

엔터티에 서명하는 데 사용할 인증서를 포함하는 CRYPTUI_WIZ_DIGITAL_SIGN_STORE_INFO 구조체에 대한 포인터입니다. 이 멤버는 dwSigningCertChoice 멤버에 대해 CRYPTUI_WIZ_DIGITAL_SIGN_STORE 지정한 경우에 사용됩니다.

pSigningCertPvkInfo

엔터티에 서명하는 데 사용할 인증서를 포함하는 CRYPTUI_WIZ_DIGITAL_SIGN_CERT_PVK_INFO 구조체에 대한 포인터입니다. 이 멤버는 dwSigningCertChoice 멤버에 대해 CRYPTUI_WIZ_DIGITAL_SIGN_PVK 지정한 경우에 사용됩니다.

pwszTimestampURL

타임스탬프를 위한 URL을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

dwAdditionalCertChoice

추가 인증서가 서명에 포함될지 여부를 나타내는 값입니다. 기본값은 영입니다. 다음 값 중 하나일 수 있습니다.

값	의미
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN	전체 인증서 체인이 서명에 포함됩니다.
CRYPTUI_WIZ_DIGITAL_SIGN_ADD_CHAIN_NO_ROOT	루트를 제외한 인증서 체인의 모든 인증서가 서명에 포함됩니다.
0	서명에 추가 인증서가 포함되지 않습니다.

pSignExtInfo

서명에 대한 확장 정보를 포함하는 CRYPTUI_WIZ_DIGITAL_SIGN_EXTENDED_INFO 구조체에 대한 포인터입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	cryptuiapi.h

추가 정보

CryptUIWizDigitalSign