ImageGetCertificateData 함수(imagehlp.h)

파일에서 전체 인증서를 검색합니다.

구문

BOOL IMAGEAPI ImageGetCertificateData(
  [in]      HANDLE            FileHandle,
  [in]      DWORD             CertificateIndex,
  [out]     LPWIN_CERTIFICATE Certificate,
  [in, out] PDWORD            RequiredLength
);

매개 변수

[in] FileHandle

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

[in] CertificateIndex

반환할 인증서의 인덱스입니다.

[out] Certificate

인증서 데이터를 수신하는 WIN_CERTIFICATE 구조체에 대한 포인터입니다. 버퍼가 구조를 포함할 만큼 크지 않으면 함수가 실패하고 마지막 오류 코드가 ERROR_INSUFFICIENT_BUFFER 설정됩니다.

[in, out] RequiredLength

입력에서 이 매개 변수는 인증서 버퍼의 길이를 바이트 단위로 지정합니다. 성공하면 인증서의 길이를 받습니다.

반환 값

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

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

설명

WIN_CERTIFICATE 구조체는 다음과 같이 정의됩니다.

typedef struct _WIN_CERTIFICATE {
    DWORD       dwLength;
    WORD        wRevision;
    WORD        wCertificateType;   // WIN_CERT_TYPE_xxx
    BYTE        bCertificate[ANYSIZE_ARRAY];
} WIN_CERTIFICATE, *LPWIN_CERTIFICATE;

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

요구 사항

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

추가 정보

ImageHlp 함수