ICEnroll::enumContainers 메서드(xenroll.h)
[이 메서드는 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 |