ICredentialProviderUserArray 인터페이스(credentialprovider.h)

로그온 또는 자격 증명 UI에 표시되는 사용자 집합을 나타냅니다. 이 정보를 사용하면 자격 증명 공급자가 집합을 열거하여 각 사용자에 대한 속성 정보를 검색하여 필드를 채움하거나 집합을 필터링할 수 있습니다.

상속

ICredentialProviderUserArray 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ICredentialProviderUserArray 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ICredentialProviderUserArray 인터페이스에는 이러한 메서드가 있습니다.

ICredentialProviderUserArray::GetAccountOptions 로컬 또는 Microsoft 계정의 "다른 사용자" 타일이 로그온 또는 자격 증명 UI에 표시되는지 여부를 나타내는 값을 검색합니다.
ICredentialProviderUserArray::GetAt 배열에서 지정된 사용자를 검색합니다.
ICredentialProviderUserArray::GetCount 사용자 배열에서 ICredentialProviderUser 개체의 수를 검색합니다.
ICredentialProviderUserArray::SetProviderFilter 배열의 사용자 집합을 로컬 계정 또는 Microsoft 계정으로 제한합니다.

설명

이 개체는 ICredentialProviderSetUserArray::SetUserArray 메서드를 통해 Windows 자격 증명 공급자 프레임워크에서 자격 증명 공급자에게 제공됩니다. 이 개체의 소유권은 자격 증명 공급자 프레임워크를 통해 유지됩니다.

구현 시기

타사에서는 이 인터페이스를 구현하지 않습니다. 구현은 Windows에 포함되어 있습니다.

예제

다음 예제에서는 이 인터페이스의 메서드 중 일부를 사용하는 시나리오를 보여 줍니다. 변수는 pcpua 이전에 선언된 ICredentialProviderUserArray 개체를 나타냅니다.

DWORD dwCount = 0;

HRESULT hr = pcpua->GetCount(&dwCount);

if (SUCCEEDED(hr))
{
    for (DWORD i = 0; i < dwCount; i++)
    {
        ICredentialProviderUser *pcpu = NULL;
        hr = pcpua->GetAt(i, &pcpu);

        if (SUCCEEDED(hr))
        {
            PWSTR pszName = NULL;
            hr = pcpu->GetStringValue(PKEY_Identity_UserName, &pszName);

            if (SUCCEEDED(hr))
            {
                // Do something with the string
                CoTaskMemFree(pszName);
            }
            pcpu->Release();
        }
    }
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	credentialprovider.h

추가 정보

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown