CryptUIWizDigitalSign 함수(cryptuiapi.h)

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

CryptUIWizDigitalSign 함수는 문서 또는 BLOB에 디지털 서명합니다. 문서 또는 BLOB은 사용자 상호 작용을 사용하거나 사용하지 않고 서명할 수 있습니다.

구문

BOOL CryptUIWizDigitalSign(
  [in]            DWORD                              dwFlags,
  [in, optional]  HWND                               hwndParent,
  [in, optional]  LPCWSTR                            pwszWizardTitle,
  [in]            PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO    pDigitalSignInfo,
  [out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);

매개 변수

[in] dwFlags

함수의 동작을 수정하는 플래그를 포함합니다. 이 값은 0 또는 다음 값일 수 있습니다.

값	의미
CRYPTUI_WIZ_NO_UI 0x0001	이 함수는 사용자 인터페이스를 표시하지 않고 pDigitalSignInfo 매개 변수가 가리키는 CRYPTUI_WIZ_DIGITAL_SIGN_INFO 구조의 정보를 기반으로 문서에 서명합니다. 이 플래그를 지정하지 않으면 이 함수는 서명 프로세스를 통해 사용자를 안내하는 마법사를 표시합니다.

[in, optional] hwndParent

이 함수가 만드는 대화 상자의 부모로 사용할 창의 핸들입니다. CRYPTUI_WIZ_NO_UI 플래그가 dwFlags에 설정된 경우 이 매개 변수는 무시됩니다.

[in, optional] pwszWizardTitle

이 함수가 만드는 대화 상자에서 사용할 제목이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다. CRYPT_WIZ_NO_UI 플래그가 dwFlags에 설정된 경우 이 매개 변수는 무시됩니다. 이 매개 변수가 NULL이면 기본 제목이 사용됩니다.

[in] pDigitalSignInfo

서명 프로세스에 대한 정보를 포함하는 CRYPTUI_WIZ_DIGITAL_SIGN_INFO 구조체에 대한 포인터입니다.

[out, optional] ppSignContext

서명된 BLOB을 수신하는 CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT 구조체 포인터에 대한 포인터입니다. 이 구조체 사용을 마치면 이 포인터를 CryptUIWizFreeDigitalSignContext 함수에 전달하여 메모리를 해제해야 합니다. 서명된 BLOB이 필요하지 않은 경우 이 매개 변수는 NULL 일 수 있습니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값을 반환합니다.

함수가 실패하면 0을 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	cryptuiapi.h
라이브러리	Cryptui.lib
DLL	Cryptui.dll

추가 정보

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext