ICEnroll::get_ContainerName 메서드(xenroll.h)

[이 속성은 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

ContainerName 속성은 사용할 키 컨테이너의 이름을 설정하거나 검색합니다.

이 속성은 ICEnroll 인터페이스에서 처음 정의되었습니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT get_ContainerName(
  BSTR *pbstrContainer
);

매개 변수

pbstrContainer

반환 값

없음

설명

지정된 컨테이너는 기존 컨테이너 또는 새 컨테이너일 수 있습니다. 키 집합이 아직 생성되지 않은 한 UseExistingKeySet 속성이 설정된 경우에만 기존 컨테이너일 수 있습니다. 예를 들어 컨테이너에 대해 교환 키 집합만 생성된 경우에도 UseExistingKeySet을 설정하지 않고 서명 키 집합을 사용하여 인증서 등록을 수행할 수 있습니다. UseExistingKeySet이 미리 설정된 경우 교환 키 집합을 사용할 수 있습니다.

기본적으로 ICEnroll 컨트롤이 실행될 때마다 새 컨테이너가 선택됩니다. 이렇게 하면 새 키 집합이 생성됩니다. 이 속성이 명시적으로 설정되지 않은 경우 생성된 GUID가 컨테이너 이름으로 사용됩니다.

ContainerName 속성은 다음 메서드의 동작에 영향을 줍니다.

• createPKCS10
• createFilePKCS10

예제

BSTR     bstrContainerName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the container name
hr = pEnroll->get_ContainerName( &bstrContainerName );
if ( FAILED ( hr ) )
    printf("Failed getting ContainerName - %x\n", hr );
else
    printf( "ContainerName: %ws\n", bstrContainerName );
// free BSTR when done
if ( NULL != bstrContainerName )
    SysFreeString( bstrContainerName );

// set the container name
// bstrMyName previously set to a valid name
hr = pEnroll->put_ContainerName( bstrMyName );
if ( FAILED ( hr ) )
    printf("Failed setting ContainerName - %x\n", hr );
else
    printf( "ContainerName was set to %ws\n", bstrMyName );

요구 사항

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