CTL_VERIFY_USAGE_STATUS 구조체(wincrypt.h)

CTL_VERIFY_USAGE_STATUS 구조에는 CertVerifyCTLUsage에서 반환된 CTL(인증서 신뢰 목록)에 대한 정보가 포함되어 있습니다.

구문

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

멤버

cbSize

구조체의 크기(바이트)입니다. CertVerifyCTLUsage를 호출하는 애플리케이션은 이 매개 변수를 설정합니다. cbSize가 구조체의 필요한 크기보다 크거나 같지 않으면 CertVerifyCTLUsage는 FALSE를 반환하고 GetLastError는 E_INVALIDARG 반환합니다.

dwError

오류는 CertVerifyCTLUsage 호출에서 반환되는 오류(있는 경우)를 상태. 가능한 오류 값 목록은 CertVerifyCTLUsage의 반환 값 섹션을 참조하세요.

dwFlags

CERT_VERIFY_UPDATED_CTL_FLAG 반환되면 CertVerifyCTLUsage는 시간이 더 이상 유효하지 않은 새 시간 유효한 CTL을 업데이트했습니다.

ppCtl

일치하는 제목을 포함하는 CTL 컨텍스트 에 대한 포인터에 대한 포인터입니다. 호출하는 애플리케이션은 이 포인터를 NULL 로 설정하여 제목이 포함된 CTL이 반환되지 않음을 나타낼 수 있습니다.

ppCtl이 NULL이 아닌 경우 호출 애플리케이션은 CertFreeCTLContext를 사용하여 반환된 컨텍스트를 해제해야 합니다.

dwCtlEntryIndex

CTL 배열에서 일치하는 주체 항목의 배열 위치를 반환합니다.

ppSigner

CTL 서명자의 인증서 컨텍스트에 대한 포인터에 대한 포인터입니다. 이 포인터는 CTL 서명자의 인증서가 반환되지 않음을 나타내는 호출 애플리케이션에 의해 NULL 로 설정할 수 있습니다.

ppSigner가 NULL이 아닌 경우 호출 애플리케이션은 CertFreeCTLContext를 사용하여 반환된 컨텍스트를 해제해야 합니다.

dwSignerIndex

실제로 사용되는 서명자의 인덱스입니다. 메시지에 둘 이상의 서명자가 있는 경우 필요합니다.

설명

dwError, dwFlags, dwCtlEntryIndex 및 dwSignerIndex 멤버는 호출 애플리케이션에 의해 0으로 초기화되어야 합니다.

요구 사항

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

추가 정보

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage