WINTRUST_DATA 구조체(wintrust.h)
[WINTRUST_DATA 구조는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 사용할 수 없습니다.]
통사론
typedef struct _WINTRUST_DATA {
DWORD cbStruct;
LPVOID pPolicyCallbackData;
LPVOID pSIPClientData;
DWORD dwUIChoice;
DWORD fdwRevocationChecks;
DWORD dwUnionChoice;
union {
#if ...
WINTRUST_FILE_INFO_ *pFile;
#else
struct WINTRUST_FILE_INFO_ *pFile;
#endif
#if ...
WINTRUST_CATALOG_INFO_ *pCatalog;
#else
struct WINTRUST_CATALOG_INFO_ *pCatalog;
#endif
#if ...
WINTRUST_BLOB_INFO_ *pBlob;
#else
struct WINTRUST_BLOB_INFO_ *pBlob;
#endif
#if ...
WINTRUST_SGNR_INFO_ *pSgnr;
#else
struct WINTRUST_SGNR_INFO_ *pSgnr;
#endif
#if ...
WINTRUST_CERT_INFO_ *pCert;
#else
struct WINTRUST_CERT_INFO_ *pCert;
#endif
#if ...
WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#else
struct WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#endif
};
DWORD dwStateAction;
HANDLE hWVTStateData;
WCHAR *pwszURLReference;
DWORD dwProvFlags;
DWORD dwUIContext;
struct WINTRUST_SIGNATURE_SETTINGS_ *pSignatureSettings;
} WINTRUST_DATA, *PWINTRUST_DATA;
회원
cbStruct
이 구조체의 크기(바이트)입니다.
pPolicyCallbackData
정책별 데이터를 정책 공급자에 전달하는 데 사용되는 데이터 버퍼에 대한 포인터입니다. 이 멤버는 NULL
pSIPClientData
SIP(주체 인터페이스 패키지) 관련 데이터를 SIP 공급자에 전달하는 데 사용되는 데이터 버퍼에 대한 포인터입니다. 이 멤버는 NULL
dwUIChoice
사용할 UI(사용자 인터페이스)의 종류를 지정합니다. 이 멤버는 다음 값 중 하나여야 합니다.
| 값 | 의미 |
|---|---|
|
모든 UI를 표시합니다. |
|
UI를 표시하지 않습니다. |
|
음수 UI를 표시하지 마세요. |
|
양수 UI를 표시하지 마세요. |
fdwRevocationChecks
인증서 해지 확인 옵션입니다. 이 멤버는 선택한 정책 공급자가 수행한 해지 확인을 추가하도록 설정할 수 있습니다. 이 멤버는 다음 값 중 하나여야 합니다.
| 값 | 의미 |
|---|---|
|
WTD_REVOKE_NONE 플래그를 WinVerifyTrust 함수의 pgActionID 매개 변수에 설정된 HTTPSPROV_ACTION 값과 함께 사용하면 추가 해지 검사가 수행되지 않습니다. WinVerifyTrust 함수가 코드 서명을 확인할 때 네트워크 검색을 시도하지 않도록 하려면 dwProvFlags 매개 변수에서 WTD_CACHE_ONLY_URL_RETRIEVAL 설정해야 합니다. |
|
해지 검사는 전체 체인에서 수행됩니다. |
dwUnionChoice
사용할 공용 구조체 멤버를 지정하므로 트러스트를 확인할 개체의 형식을 지정합니다. 이 멤버는 다음 값 중 하나여야 합니다.
| 값 | 의미 |
|---|---|
|
pFile |
|
pCatalog |
|
pBlob가리키는 BLOB 사용합니다. |
|
pSgnr가리키는 [WINTRUST_SGNR_INFO](/windows/desktop/api/wintrust/ns-wintrust-wintrust_sgnr_info) 구조체를 사용합니다. |
|
pCert |
pFile
WINTRUST_FILE_INFO 구조체에 대한 포인터입니다.
pCatalog
WINTRUST_CATALOG_INFO 구조체에 대한 포인터입니다.
pBlob
WINTRUST_BLOB_INFO 구조체에 대한 포인터입니다.
pSgnr
WINTRUST_SGNR_INFO 구조체에 대한 포인터입니다.
pCert
WINTRUST_CERT_INFO 구조체에 대한 포인터입니다.
pDetachedSig
dwStateAction
수행할 작업을 지정합니다. 다음 값 중 하나일 수 있습니다.
hWVTStateData
상태 데이터에 대한 핸들입니다. 이 멤버의 내용은 dwStateAction 멤버의 값에 따라 달라집니다.
pwszURLReference
나중에 사용할 수 있습니다. NULL
dwProvFlags
신뢰 공급자 설정을 지정하는 DWORD 값입니다. 다음 값 중 0개 이상의 비트 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
신뢰는 Internet Explorer 4.0에서 구현한 것과 동일한 방식으로 확인됩니다. |
|
Internet Explorer 4.0 체인 기능은 사용되지 않습니다. |
|
Authenticode대한 코드 서명과 같은 정책 공급자의 기본 확인은 수행되지 않으며 인증서는 모든 사용에 유효한 것으로 간주됩니다. |
|
해지 확인이 수행되지 않습니다. |
|
해지 검사는 최종 인증서에서만 수행됩니다. |
|
해지 검사는 전체 인증서 체인에서 수행됩니다. |
|
해지 검사는 루트 인증서를 제외한 전체 인증서 체인에서 수행됩니다. |
|
지원되지 않습니다. |
|
해시만 확인됩니다. |
|
기본 운영 체제 버전 검사가 수행됩니다. 이 플래그는 카탈로그 서명 파일을 확인하는 데만 사용됩니다. |
|
이 플래그를 설정하지 않으면 타임스탬프를 찍은 모든 서명이 영원히 유효한 것으로 간주됩니다. 이 플래그를 설정하면 서명의 유효한 수명이 서명 인증서의 수명으로 제한됩니다. 이렇게 하면 타임스탬프를 찍은 서명이 만료될 수 있습니다. |
|
해지 확인에는 로컬 캐시만 사용합니다. 네트워크를 통해 해지 검사를 방지합니다.
Windows XP: 이 값은 지원되지 않습니다. |
|
MD2 및 MD4 해시 알고리즘 사용을 사용하지 않도록 설정합니다. MD2 또는 MD4를 사용하여 파일에 서명하고 이 플래그가 설정되면 NTE_BAD_ALGID 오류가 반환됩니다.
참고 이 플래그는 WINDOWS 7 SP1 이상 운영 체제에서 지원됩니다.
|
|
이 플래그를 지정하면 확인 중인 파일이 웹에서 다운로드되었으며 웹의 Mark 특성이 있다고 가정합니다. 웹 파일의 표시에 적용하려는 정책이 적용됩니다.
참고 이 플래그는 Windows 8.1 이상 운영 체제 또는 KB2862966 설치한 시스템에서 지원됩니다.
|
dwUIContext
WinVerifyTrust 함수의 사용자 인터페이스 컨텍스트를 지정하는 DWORD 값입니다. 이렇게 하면 Authenticode 대화 상자의 텍스트가 파일에서 수행한 작업과 일치합니다. 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
실행할 파일에 대해 WinVerifyTrust 호출할 때 사용합니다. 기본값입니다. |
|
설치할 파일에 대해 WinVerifyTrust 호출할 때 사용합니다. |
pSignatureSettings
WINTRUST_SIGNATURE_SETTINGS 구조체에 대한 포인터입니다.
KB3033929, Windows 8 및 Windows Server 2012를 사용하는 Windows 7 : 이 멤버에 대한 지원이 시작됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 | wintrust.h |