CertGetValidUsages 함수(wincrypt.h)

CertGetValidUsages 함수는 인증서 배열의 모든 인증서에 대해 유효한 사용법의 교집합으로 구성된 사용량 배열을 반환합니다.

구문

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

매개 변수

[in] cCerts

검사할 배열의 인증서 수입니다.

[in] rghCerts

유효한 사용을 확인할 인증서 배열입니다.

[out] cNumOIDs

배열에 있는 모든 인증서의 유효한 사용법의 교집합으로 발견된 유효한 사용량의 수입니다. 모든 인증서가 모든 사용량에 유효한 경우 cNumOID 는 음수(-1)로 설정됩니다.

[out] rghOIDs

rghCerts 배열의 모든 인증서에서 공유하는 유효한 사용법의 개체 식별자(OID)의 배열입니다. 이 매개 변수는 메모리 할당을 위해 이 구조체의 크기를 설정하는 NULL 일 수 있습니다. 자세한 내용은 알 수 없는 길이의 데이터 검색을 참조하세요.

[in, out] pcbOIDs

rghOID 배열과 가리키는 문자열의 크기(바이트)를 지정하는 DWORD 값에 대한 포인터입니다. 함수가 반환될 때 DWORD 값에는 배열에 필요한 바이트 수가 포함됩니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다. 함수가 실패하면 반환 값은 0입니다. 확장 오류 정보는 GetLastError를 호출합니다.

요구 사항

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