다음을 통해 공유

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

  • 아티클

GetMyRoles 메서드는 호출자의 CA(인증 기관) 역할을 검색합니다.

구문

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

매개 변수

[in] strConfig

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

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

[out] pRoles

호출자에 대해 검색된 CA 역할을 나타내는 LONG 값에 대한 포인터입니다. 다음 값 중 0개 이상의 비트 조합일 수 있습니다.

값 의미
CA_ACCESS_ADMIN
0x1
 호출자에는 CA 관리자 기능이 있습니다.
CA_ACCESS_AUDITOR
0x4
 호출자에는 CA 감사자 기능이 있습니다.
CA_ACCESS_ENROLL
0x200
 호출자에게 등록 액세스 권한이 있습니다.
CA_ACCESS_OFFICER
0x2
 호출자에는 CA 책임자 기능이 있습니다.
CA_ACCESS_OPERATOR
0x8
 호출자에는 CA 백업 기능이 있습니다.
CA_ACCESS_READ
0x100
 호출자에게 CA 읽기 권한이 있습니다.

반환 값

C++

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

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

VB

반환 값은 호출자에 대해 검색된 CA 역할을 나타내는 Long 값입니다. 다음 값 중 0개 이상의 비트 조합일 수 있습니다.
반환 코드/값 설명
CA_ACCESS_ADMIN
0x1
 호출자에는 CA 관리자 기능이 있습니다.
CA_ACCESS_AUDITOR
0x4
 호출자에는 CA 감사자 기능이 있습니다.
CA_ACCESS_ENROLL
0x200
 호출자에게 등록 액세스 권한이 있습니다.
CA_ACCESS_OFFICER
0x2
 호출자에는 CA 책임자 기능이 있습니다.
CA_ACCESS_OPERATOR
0x8
 호출자에는 CA 백업 기능이 있습니다.
CA_ACCESS_READ
0x100
 호출자에게 읽기 권한이 있습니다.

요구 사항

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

추가 정보

ICertAdmin2