CRYPTUI_VIEWCERTIFICATE_STRUCTA 구조체(cryptuiapi.h)

아티클
02/24/2024

CRYPTUI_VIEWCERTIFICATE_STRUCT 구조에는 볼 인증서에 대한 정보가 포함되어 있습니다. 이 구조체는 CryptUIDlgViewCertificate 함수에 사용됩니다.

구문

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCSTR            szTitle;
  PCCERT_CONTEXT    pCertContext;
  LPCSTR            *rgszPurposes;
  DWORD             cPurposes;
  union {
    CRYPT_PROVIDER_DATA const *pCryptProviderData;
    HANDLE                    hWVTStateData;
  };
  BOOL              fpCryptProviderDataTrustedUsage;
  DWORD             idxSigner;
  DWORD             idxCert;
  BOOL              fCounterSigner;
  DWORD             idxCounterSigner;
  DWORD             cStores;
  HCERTSTORE        *rghStores;
  DWORD             cPropSheetPages;
  LPCPROPSHEETPAGEA rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;

멤버

dwSize

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

hwndParent

CryptUIDlgViewCertificate에서 생성된 대화 상자의 부모인 창에 대한 핸들입니다.

dwFlags

이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값	의미
CRYPTUI_HIDE_HIERARCHYPAGE	인증 경로 페이지를 사용할 수 없습니다.
CRYPTUI_HIDE_DETAILPAGE	세부 정보 페이지를 사용할 수 없습니다.
CRYPTUI_DISABLE_EDITPROPERTIES	사용자가 속성을 변경할 수 없습니다.
CRYPTUI_ENABLE_EDITPROPERTIES	사용자는 속성을 변경할 수 있습니다.
CRYPTUI_DISABLE_ADDTOSTORE	설치 단추를 사용할 수 없습니다.
CRYPTUI_ENABLE_ADDTOSTORE	설치 단추를 사용할 수 있습니다.
CRYPTUI_ACCEPT_DECLINE_STYLE	사용자가 결정을 수락하거나 거절할 수 있는 페이지 또는 단추는 사용하지 않도록 설정됩니다.
CRYPTUI_IGNORE_UNTRUSTED_ROOT	신뢰할 수 없는 루트 오류는 무시됩니다.
CRYPTUI_DONT_OPEN_STORES	알려진 신뢰할 수 있는 저장소는 체인을 빌드하는 데 사용되지 않습니다.
CRYPTUI_ONLY_OPEN_ROOT_STORE	알려진 신뢰할 수 있는 루트 저장소는 체인을 빌드하는 데 사용되지 않습니다.
CRYPTUI_WARN_UNTRUSTED_ROOT	원격 컴퓨터에서 인증서를 볼 때만 사용합니다. 이 플래그를 사용하는 경우 rghStores 의 첫 번째 요소는 원격 컴퓨터의 루트 저장소 핸들이어야 합니다.
CRYPTUI_ENABLE_REVOCATION_CHECKING	기본 동작으로 해지 확인을 사용하도록 설정합니다. 기본 동작은 루트 인증서를 제외한 전체 인증서 체인의 해지 검사를 사용하도록 설정하는 것입니다. pCryptProviderData와 hWVTStateData 공용 구조체 멤버가 모두 전달되지 않은 경우에만 유효합니다.
CRYPTUI_WARN_REMOTE_TRUST	원격 컴퓨터에 대한 인증서 체인을 빌드할 때 원격 컴퓨터에서 체인을 신뢰할 수 없음을 경고합니다.
CRYPTUI_DISABLE_EXPORT	이 플래그를 설정하면 세부 정보 페이지에서 파일로 복사 단추가 비활성화됩니다.
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT	인증서 체인의 리프 인증서에서만 해지 검사를 사용하도록 설정합니다. pCryptProviderData와 hWVTStateData 공용 구조체 멤버가 모두 전달되지 않은 경우에만 유효합니다.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN	인증서 체인의 각 인증서에서 해지 확인을 사용하도록 설정합니다. pCryptProviderData와 hWVTStateData 공용 구조체 멤버가 모두 전달되지 않은 경우에만 유효합니다. 참고 루트 인증서에는 해지 검사를 허용하는 정보가 거의 포함되지 않으므로 이 옵션을 사용하면 일반적으로 CryptUIDlgViewCertificate 함수가 실패할 것으로 예상됩니다. 권장되는 옵션은 CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT 사용하는 것입니다.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT	루트 인증서를 제외한 인증서 체인의 각 인증서에서 해지 확인을 사용하도록 설정합니다. 인증서 해지 검사에 사용하는 것이 좋습니다. pCryptProviderData와 hWVTStateData 공용 구조체 멤버가 모두 전달되지 않은 경우에만 유효합니다. 참고 이 플래그는 CRYPTUI_ENABLE_REVOCATION_CHECKING 동일합니다.
CRYPTUI_DISABLE_HTMLLINK	인증서 대화 상자에서 HTML 도움말 단추(?)를 사용하지 않도록 설정합니다.
CRYPTUI_DISABLE_ISSUERSTATEMENT	인증서 대화 상자의 일반 탭에서 발급자 문 단추를 사용하지 않도록 설정합니다.
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL	온라인 해지 확인을 사용하지 않도록 설정합니다. CryptUIDlgViewCertificate 함수가 로컬 캐시를 사용하여 인증서를 검색하고 네트워크에서 인증서를 검색하지 않도록 하려면 이 플래그를 설정합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 플래그는 지원되지 않습니다.

szTitle

창의 제목을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

pCertContext

표시할 인증서 컨텍스트를 포함하는 CERT_CONTEXT 구조체에 대한 포인터입니다.

rgszPurposes

이 인증서의 유효성을 검사할 목적을 포함하는 null로 끝나는 문자열에 대한 포인터 배열입니다.

cPurposes

rgszPurposes 배열의 용도 수입니다.

pCryptProviderData

WinVerifyTrust 함수가 인증서에 대해 이미 호출되었고 WTHelperProvDataFromStateData 함수도 호출된 경우 WTHelperProvDataFromStateData 호출에서 얻은 상태 구조에 대한 포인터를 전달합니다. pCryptProviderData가 설정된 경우 fpCryptProviderDataTrustedUsage, idxSigner, idxCert 및 fCounterSignature도 설정해야 합니다.

hWVTStateData

WinVerifyTrust가 인증서에 대해 이미 호출되었고 WTHelperProvDataFromStateData가 호출되지 않은 경우 WINTRUST_DATA 구조체의 hWVTStateData 멤버를 전달합니다. hWVTStateData가 설정된 경우 fpCryptProviderDataTrustedUsage, idxSigner, idxCert 및 fCounterSignature도 설정해야 합니다.

fpCryptProviderDataTrustedUsage

WinVerifyTrust가 호출된 경우 인증서가 신뢰할 수 있는지 여부의 결과입니다.

idxSigner

볼 서명자의 인덱스입니다.

idxCert

서명자 체인 내에서 볼 인증서의 인덱스입니다. 이 인증서의 인증서 컨텍스트는 pCertContext와 일치해야 합니다.

fCounterSigner

TRUE 이면 반대 서명이 표시됩니다. TRUE이면 idxCounterSigner가 유효해야 합니다.

idxCounterSigner

볼 카운터 서명자의 인덱스입니다.

cStores

인증서 체인을 빌드하고 유효성을 검사할 때 검색할 인증서 저장소의 rghStores 배열에 있는 다른 저장소의 수입니다.

rghStores

HCERTSTORE의 배열은 인증서 체인을 빌드하고 유효성을 검사할 때 검색할 다른 인증서 저장소에 대한 핸들입니다.

cPropSheetPages

대화 상자에 추가할 속성 페이지 수입니다.

rgPropSheetPages

대화 상자에 추가할 속성 페이지의 배열입니다. 이 배열의 각 페이지는 PROPSHEETPAGE 구조의 lParam을 WM_INITDIALOG 메시지의 lParam으로 받지 않습니다. 대신 CRYPTUI_INITDIALOG_STRUCT 구조체에 대한 포인터를 받습니다. PROPSHEETPAGE의 lParam과 페이지가 표시되는 CERT_CONTEXT 대한 포인터가 포함됩니다.

nStartPage

표시할 초기 페이지의 인덱스입니다. 가장 높은 비트(0x8000)가 설정된 경우 인덱스는 인덱스 rgPropSheetPages로 간주됩니다(예를 들어 가장 높은 비트가 제거된 후 0x8000 rgPropSheetPages의 첫 번째 페이지를 나타냅니다). 가장 높은 비트가 0이면 nStartPage 는 기본 인증서 대화 상자 속성 페이지의 시작 인덱스가 됩니다.

설명

참고

cryptuiapi.h 헤더는 CRYPTUI_VIEWCERTIFICATE_STRUCT 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

CryptUIDlgViewCertificate

Share via

CRYPTUI_VIEWCERTIFICATE_STRUCTA 구조체(cryptuiapi.h)

구문

멤버

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스