ICredentialProviderUserArray 介面 (credentialprovider.h)

代表將出現在登入或認證UI中的一組使用者。 這項資訊可讓認證提供者列舉集合，以擷取每個使用者的屬性資訊，以填入字段或篩選集合。

繼承

ICredentialProviderUserArray 介面繼承自 IUnknown 介面。 ICredentialProviderUserArray 也有下列類型的成員：

方法

ICredentialProviderUserArray 介面具有這些方法。

ICredentialProviderUserArray：：GetAccountOptions 擷取值，指出登入或認證UI中是否顯示本機或 Microsoft 帳戶的 [其他使用者] 圖格。
ICredentialProviderUserArray：：GetAt 從陣列擷取指定的使用者。
ICredentialProviderUserArray：：GetCount 擷取用戶數位中的 ICredentialProviderUser 物件數目。
ICredentialProviderUserArray：：SetProviderFilter 將陣列中的使用者集限制為本機帳戶或 Microsoft 帳戶。

備註

此物件是由 Windows 認證提供者架構透過 ICredentialProviderSetUserArray：：SetUserArray 方法提供給認證提供者。 此對象的擁有權會與認證提供者架構保持一起。

實作時機

第三方不會實作此介面。 實作隨附於 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