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

아티클
08/28/2023

[이 메서드는 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

enumContainers 메서드는 ProviderName 속성에 지정된 CSP(암호화 서비스 공급자)의 컨테이너 이름을 검색합니다. 이 메서드는 ICEnroll 인터페이스에서 처음 정의되었습니다.

구문

HRESULT enumContainers(
  [in]  LONG dwIndex,
  [out] BSTR *pbstr
);

매개 변수

[in] dwIndex

이름이 검색될 컨테이너의 서수 위치를 지정합니다. 첫 번째 컨테이너에 대해 0을 지정합니다.

[out] pbstr

컨테이너의 이름을 수신하는 BSTR 변수에 대한 포인터입니다. BSTR 사용을 마쳤으면 SysFreeString 함수를 호출하여 해제합니다.

반환 값

C++

반환 값은 HRESULT입니다. S_OK 값은 성공을 나타냅니다. 더 이상 항목이 없으면 ERROR_NO_MORE_ITEMS 값이 반환됩니다.

VB

반환 값은 컨테이너의 이름을 나타내는 String 변수입니다. 오류가 발생하거나 항목이 더 이상 없는 경우 예외가 발생합니다.

설명

ProviderName 속성 값이 설정되지 않은 경우 레지스트리에 설정된 ProviderName의 기본값(일반적으로 Microsoft 기본 암호화 공급자)이 사용됩니다.

인증서 등록 컨트롤이 스크립팅된 컨트롤로 실행될 때 이 메서드를 사용할 수 없습니다.

예제

BSTR       bstrCon = NULL;
DWORD      nCon = 0;
HRESULT    hr;

// pEnroll is previously instantiated ICEnroll interface pointer
while ( S_OK == pEnroll->enumContainers(nCon, &bstrCon) )
{
    printf("\t%d) %ws\n", nCon++, bstrCon );
    if ( bstrCon )
    {
        SysFreeString( bstrCon );
        bstrCon = NULL;
    }
}

요구 사항

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