ICertRequest2::GetCAPropertyDisplayName 메서드(certcli.h)

아티클
08/22/2023

GetCAPropertyDisplayName 메서드는 CA(인증 기관) 속성의 속성 표시 이름을 검색합니다.

구문

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

매개 변수

[in] strConfig

ComputerName CAName\ 형식의 CA에 대한 유효한 구성 문자열을 나타냅니다. 여기서 ComputerName은 인증서 서비스 서버의 네트워크 이름이며 CAName은 인증서 서비스 설정 중에 입력한 대로 CA의 일반 이름입니다. 구성 문자열 이름에 대한 자세한 내용은 ICertConfig를 참조하세요.

[in] PropId

속성 식별자를 지정합니다. 이 매개 변수에 대한 자세한 내용은 ICertAdmin2::GetCAProperty의 테이블을 참조하세요.

[out, retval] pstrDisplayName

속성의 표시 이름을 나타내는 BSTR 에 대한 포인터입니다. BSTR 사용을 마쳤으면 SysFreeString 함수를 호출하여 해제합니다.

반환 값

C++

메서드가 성공하면 메서드는 S_OK 반환합니다.

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

VB

반환 값은 속성의 표시 이름을 포함하는 String 입니다.

설명

GetCAPropertyDisplayName 메서드의 기능은 ICertAdmin2::GetCAPropertyDisplayName 메서드의 기능과 유사합니다.

ICertAdmin2 메서드에서 CA는 일반적으로 CA 임원 및 CA 관리자에게만 부여되는 CA 읽기 권한을 호출자에게 적용합니다.

반면, 메서드의 ICertRequest2 및 ICertRequest3 구현에서 CA는 기본적으로 액세스 권한이 필요하지 않습니다. DCOM(분산 구성 요소 개체 모델) ACL( 액세스 제어 목록 )만 적용됩니다. 도메인에 가입된 CA의 경우 DCOM ACL은 모든 사용자가 CA에 액세스할 수 있도록 허용합니다. 모든 사람은 익명을 포함하지 않습니다. CA의 요청 인터페이스는 레지스트리 구성을 사용하여 호출자에게 등록 액세스 권한이 있음을 적용하여 잠글 수 있습니다.

요구 사항

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