ICertManageModule::Configure 메서드(certmod.h)

Configure 메서드는 모듈 사용자 인터페이스를 표시합니다.

구문

HRESULT Configure(
  [in] const BSTR strConfig,
  [in] BSTR       strStorageLocation,
  [in] LONG       Flags
);

매개 변수

[in] strConfig

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

[in] strStorageLocation

ICertManageModule::GetProperty의 strStorageLocation 정의에 설명된 대로 속성 값에 대한 스토리지를 제공하는 위치입니다.

[in] Flags

구성 인터페이스를 사용자에게 표시할지 여부를 결정하는 데 사용되는 값입니다. 이 값이 0이면 사용자에게 모듈을 구성하기 위한 인터페이스가 표시됩니다. 이 값이 CMM_REFRESHONLY 경우 Certificate Services는 사용자 인터페이스를 표시하지 않지만 이후 인증서 요청이 처리될 때 모듈 구성에 대한 최신 변경 내용이 적용됩니다(사용자 인터페이스에 대한 응답 없이 변경 내용을 통합할 수 있습니다).

반환 값

VB

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

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

설명

Configure 메서드는 사용자가 모듈의 구성 가능한 항목을 보고 변경할 수 있는 모듈 사용자 인터페이스(있는 경우)를 표시합니다. ICertManageModule을 구현하는 모듈은 인증서 서비스 관리자 정책 또는 종료 모듈 속성 페이지가 활성 상태이고 사용자가 구성 단추를 선택할 때 라는 Configure 메서드를 가질 수 있습니다. 인증서 서비스 관리자는 strStorageLocation 에서 참조하는 위치를 이 모듈에 전달하고, 이 메서드의 구현은 필요에 따라 이 위치를 사용할 수 있습니다. 모듈에 구성 가능한 항목이 없을 수 있습니다(따라서 사용자 인터페이스가 필요하지 않음). 그러나 이 메서드를 구현하는 데는 여전히 필요합니다. 아래 예제에서는 사용자가 구성을 변경할 수 없지만 이 메서드를 구현합니다.

예제

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::Configure( 
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ LONG Flags)
{
    if ( CMM_REFRESHONLY != Flags )
        MessageBox(NULL,
                   L"This module has no configurable items",
                   L"MyModule",
                   (MB_OK|MB_ICONINFORMATION));

    return S_OK;
}

요구 사항

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

추가 정보

ICertConfig

ICertManageModule