ICertAdmin2::GetConfigEntry 메서드(certadm.h)

GetConfigEntry 메서드는 CA(인증 기관)에 대한 구성 정보를 검색합니다.

구문

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] VARIANT    *pvarEntry
);

매개 변수

[in] strConfig

COMPUTERNAME\CANAME 형식의 CA에 대한 유효한 구성 문자열을 나타내는 문자열 값입니다. 여기서 COMPUTERNAME은 인증서 서비스 서버의 네트워크 이름이고 CANAME는 인증서 서비스 설정 중에 입력한 대로 CA의 일반적인 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요. 이 매개 변수는 빈 문자열일 수 있으며, 이 경우 함수는 CA와 관련이 없는 구성 정보를 검색합니다. 이 매개 변수는 NULL일 수 없습니다.

중요GetConfigEntry 는 구성 문자열이 변경되면 내부 캐시를 지우지 않습니다. CA에 대한 구성 문자열을 변경하는 경우 새 ICertAdmin 개체를 인스턴스화하고 새 구성 문자열을 사용하여 이 메서드를 다시 호출해야 합니다.

 

[in] strNodePath

구성 정보의 노드 경로를 나타내는 문자열 값입니다. 이 매개 변수는 빈 문자열일 수 있으며, 이 경우 함수는 strConfig로 식별된 경로에서 구성 정보를 검색합니다. 이 매개 변수는 NULL일 수 없습니다.

[in] strEntryName

정보를 검색할 항목의 이름을 나타내는 문자열 값입니다. 이 값은 빈 문자열일 수 있으며, 이 경우 모든 항목 이름이 검색됩니다. 이 매개 변수는 NULL일 수 없습니다.

[out] pvarEntry

요청된 정보를 수신하는 VARIANT 에 대한 포인터입니다.

반환 값

C++

함수가 성공하면 반환 값이 S_OK.

함수가 실패하면 반환 값은 오류를 나타내는 HRESULT 입니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

VB

반환 값은 검색된 구성 정보를 나타내는 Variant 입니다.

설명

구성 정보는 다음 경로 아래의 레지스트리에 저장됩니다.

Hkey_local_machine\시스템\CurrentControlSet\서비스\CertSvc\구성\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

여기서 CASANITIZEDNAME 은 CA의 삭제된 이름 입니다. 삭제된 이름에 대한 자세한 내용은 ICertConfig2::GetConfig를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certadm.h(Certsrv.h 포함)
라이브러리	Certidl.lib
DLL	Certadm.dll

추가 정보

ICertAdmin2