CertCreateCTLEntryFromCertificateContextProperties 함수(wincrypt.h)

CertCreateCTLEntryFromCertificateContextProperties 함수는 해당 특성이 인증서 컨텍스트의 속성인 CTL(인증서 신뢰 목록) 항목을 만듭니다. CTL 항목의 SubjectIdentifier는 인증서의 SHA1 해시입니다.

인증서 속성은 특성으로 추가됩니다. 속성 특성 OID는 szOID_CERT_PROP_ID_PREFIX 앞에 오는 10진수 PROP_ID. 각 속성 값은 단일 특성 값으로 복사됩니다.

cOptAttr 및 rgOptAttr 매개 변수를 사용하여 CTL 항목에 추가 특성을 포함할 수 있습니다.

구문

BOOL CertCreateCTLEntryFromCertificateContextProperties(
  [in]      PCCERT_CONTEXT   pCertContext,
  [in]      DWORD            cOptAttr,
  [in]      PCRYPT_ATTRIBUTE rgOptAttr,
  [in]      DWORD            dwFlags,
  [in]      void             *pvReserved,
  [out]     PCTL_ENTRY       pCtlEntry,
  [in, out] DWORD            *pcbCtlEntry
);

매개 변수

[in] pCertContext

CTL을 만드는 데 사용되는 CERT_CONTEXT 대한 포인터입니다.

[in] cOptAttr

추가할 추가 특성 수를 지정하는 DWORD 입니다.

[in] rgOptAttr

CTL에 추가할 CRYPT_ATTRIBUTE 특성 배열에 대한 포인터입니다.

[in] dwFlags

DWORD입니다. 체인 빌드 해시 속성을 특성으로 강제로 포함하도록 CTL_ENTRY_FROM_PROP_CHAIN_FLAG 설정할 수 있습니다.

[in] pvReserved

VOID에 대한 포인터입니다. 다음에 사용하도록 예약됩니다.

[out] pCtlEntry

CTL_ENTRY 구조체에 대한 포인터의 주소입니다. CTL 항목을 검색하려면 이 함수를 두 번 호출합니다. 첫 번째 호출에서 이 매개 변수를 NULL 로 설정합니다. 함수가 반환될 때 pcbCtlEntry 매개 변수에서 검색된 바이트 수를 사용하여 메모리를 할당합니다. 함수를 다시 호출하여 이 매개 변수를 할당된 메모리의 주소로 설정합니다.

[in, out] pcbCtlEntry

CTL_ENTRY 구조체에 할당해야 하는 바이트 수를 포함하는 DWORD에 대한 포인터입니다. 바이트 수를 검색하려면 이 함수를 두 번 호출합니다. 첫 번째 호출의 경우 이 매개 변수를 0이 포함된 DWORD 값의 주소로 설정하고 pCtlEntry 매개 변수를 NULL로 설정합니다. 첫 번째 호출이 성공하면 DWORD 값에 CTL_ENTRY 구조에 할당해야 하는 바이트 수가 포함됩니다. 필요한 메모리를 할당하고 함수를 다시 호출하여 pCtlEntry 매개 변수에 메모리 주소를 입력합니다.

반환 값

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

함수가 실패하면 0(FALSE)을 반환합니다. 확장 오류 정보는 GetLastError를 호출합니다.

요구 사항

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