Interface ICredentialProviderUserArray (credentialprovider.h)

Representa o conjunto de usuários que aparecerá no logon ou na interface do usuário de credencial. Essas informações permitem que o provedor de credenciais enumere o conjunto para recuperar informações de propriedade sobre cada usuário para preencher campos ou filtrar o conjunto.

Herança

A interface ICredentialProviderUserArray herda da interface IUnknown . ICredentialProviderUserArray também tem esses tipos de membros:

Métodos

A interface ICredentialProviderUserArray tem esses métodos.

ICredentialProviderUserArray::GetAccountOptions Recupera um valor que indica se o bloco "Outro usuário" para contas locais ou da Microsoft é mostrado na interface do usuário de logon ou credencial.
ICredentialProviderUserArray::GetAt Recupera um usuário especificado da matriz.
ICredentialProviderUserArray::GetCount Recupera o número de objetos ICredentialProviderUser na matriz de usuários.
ICredentialProviderUserArray::SetProviderFilter Limita o conjunto de usuários na matriz a contas locais ou contas da Microsoft.

Comentários

Esse objeto é fornecido pela estrutura do provedor de credenciais do Windows para seu provedor de credenciais por meio do método ICredentialProviderSetUserArray::SetUserArray . A propriedade desse objeto permanece com a estrutura do provedor de credenciais.

Quando implementar

Terceiros não implementam essa interface. Uma implementação está incluída no Windows.

Exemplos

O exemplo a seguir demonstra um cenário que usa alguns dos métodos dessa interface. A pcpua variável representa um objeto ICredentialProviderUserArray declarado anteriormente.

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();
        }
    }
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	credentialprovider.h

Confira também

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown