ICertRequest2::GetCAProperty 메서드(certcli.h)
GetCAProperty 메서드는 CA(인증 기관)에 대한 속성 값을 검색합니다. 이 메서드의 기능은 ICertAdmin2::GetCAProperty와 동일합니다. 이 메서드에 대한 자세한 내용은 ICertAdmin2::GetCAProperty를 참조하세요.
구문
HRESULT GetCAProperty(
[in] const BSTR strConfig,
[in] LONG PropId,
[in] LONG PropIndex,
[in] LONG PropType,
[in] LONG Flags,
[out, retval] VARIANT *pvarPropertyValue
);
매개 변수
[in] strConfig
COMPUTERNAME\CANAME 형식의 CA에 대한 유효한 구성 문자열을 나타냅니다. 여기서 COMPUTERNAME은 인증서 서비스 서버의 네트워크 이름이고 CANAME는 인증서 서비스 설정 중에 입력한 대로 CA의 일반 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요.
[in] PropId
속성 식별자를 지정합니다. 이 매개 변수에 대한 자세한 내용은 ICertAdmin2::GetCAProperty의 테이블을 참조하세요.
[in] PropIndex
PropId가 인덱싱되면 속성 값을 검색할 때 사용할 0부터 시작하는 인덱스입니다. PropId가 인덱싱되지 않으면 이 값은 무시됩니다.
[in] PropType
PropId 테이블의 Type 열에 해당하는 속성의 형식을 지정합니다. 형식은 다음 형식 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
서명된 긴 데이터 |
|
날짜/시간(향후 사용을 위해 예약됨) |
|
이진 데이터 |
|
유니코드 문자열 데이터 |
[in] Flags
다음 플래그를 사용하여 반환된 속성 값의 형식을 지정할 수 있습니다. 이러한 플래그는 이진 데이터(예: 인증서, 인증서 체인 또는 인증서 해지 목록)에 대해서만 의미가 있으며, 그렇지 않으면 무시됩니다.
[out, retval] pvarPropertyValue
요청된 속성 값을 받는 VARIANT 에 대한 포인터입니다.
VARIANT 사용을 마쳤으면 VariantClear 함수를 호출하여 해제합니다.
반환 값
C++
메서드가 성공하면 메서드는 S_OK 반환합니다.메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.
VB
반환 값은 요청된 속성 값을 받는 Variant 입니다.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certcli.h(Certsrv.h 포함) |
| 라이브러리 | Certidl.lib |
| DLL | Certcli.dll |
추가 정보
CCertRequest