ImageEnumerateCertificates 함수(imagehlp.h)

이미지 파일에 현재 포함된 인증서에 대한 정보를 검색합니다.

구문

BOOL IMAGEAPI ImageEnumerateCertificates(
  [in]           HANDLE FileHandle,
  [in]           WORD   TypeFilter,
  [out]          PDWORD CertificateCount,
  [in, out]      PDWORD Indices,
  [in, optional] DWORD  IndexCount
);

매개 변수

[in] FileHandle

검사할 이미지 파일에 대한 핸들입니다. 이 핸들은 FILE_READ_DATA 액세스를 위해 열어야 합니다.

[in] TypeFilter

인증서 정보를 반환할 때 필터로 사용할 인증서 섹션 유형입니다. 이미지에 있는 모든 섹션 형식에 대한 정보를 보려면 CERT_SECTION_TYPE_ANY 전달해야 합니다.

[out] CertificateCount

TypeFilter 매개 변수로 지정된 형식의 섹션을 포함하는 이미지의 인증서 수를 받는 변수에 대한 포인터입니다. 찾을 수 없는 경우 이 매개 변수는 0입니다.

[in, out] Indices

필요에 따라 지정된 형식의 섹션이 포함된 인증서에 인덱스 배열을 반환하는 데 사용할 버퍼를 제공합니다. 인덱스 값에 대해 순서를 가정해서는 안 되며, CERT_SECTION_TYPE_ANY 쿼리될 때 연속되도록 보장되지도 않습니다.

[in, optional] IndexCount

DWORD의 인덱스 버퍼 크기입니다. 이 매개 변수는 인덱스가 있을 때마다 검사됩니다. CertificateCount가 IndexCount보다 크면 인덱스는 이미지에 있는 첫 번째 IndexCount 섹션으로 채워집니다. 다른 모든 항목은 반환되지 않습니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

ImageEnumerateCertificates 함수는 이미지 파일에 현재 포함된 인증서에 대한 정보를 반환합니다. 단일 형식(또는 모든 형식)의 섹션을 포함하는 인증서를 반환할 수 있는 필터링 기능이 있습니다.

흥미로운 인증서의 인덱스를 검색한 후 ImageGetCertificateData 함수에 전달하여 인증서의 실제 본문을 가져올 수 있습니다.

이 함수와 같은 모든 ImageHlp 함수는 단일 스레드입니다. 따라서 둘 이상의 스레드에서 이 함수로 호출하면 예기치 않은 동작이나 메모리 손상이 발생할 수 있습니다. 이를 방지하려면 둘 이상의 스레드에서 이 함수로의 모든 동시 호출을 동기화해야 합니다.

요구 사항

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

참고 항목

ImageGetCertificateData

ImageHlp 함수