Interfaz ICredentialProviderUserArray (credentialprovider.h)

Representa el conjunto de usuarios que aparecerán en la interfaz de usuario de inicio de sesión o credencial. Esta información permite al proveedor de credenciales enumerar el conjunto para recuperar información de propiedad sobre cada usuario para rellenar los campos o filtrar el conjunto.

Herencia

La interfaz ICredentialProviderUserArray hereda de la interfaz IUnknown . ICredentialProviderUserArray también tiene estos tipos de miembros:

Métodos

La interfaz ICredentialProviderUserArray tiene estos métodos.

ICredentialProviderUserArray::GetAccountOptions Recupera un valor que indica si el icono "Otro usuario" para cuentas locales o microsoft se muestra en la interfaz de usuario de inicio de sesión o credencial.
ICredentialProviderUserArray::GetAt Recupera un usuario especificado de la matriz.
ICredentialProviderUserArray::GetCount Recupera el número de objetos ICredentialProviderUser en la matriz de usuarios.
ICredentialProviderUserArray::SetProviderFilter Limita el conjunto de usuarios de la matriz a cuentas locales o cuentas de Microsoft.

Comentarios

El marco del proveedor de credenciales de Windows proporciona este objeto al proveedor de credenciales mediante el método ICredentialProviderSetUserArray::SetUserArray . La propiedad de este objeto permanece con el marco del proveedor de credenciales.

Cuándo implementar

Los terceros no implementan esta interfaz. Se incluye una implementación con Windows.

Ejemplos

En el ejemplo siguiente se muestra un escenario que usa algunos de los métodos de esta interfaz. La pcpua variable representa un 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	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	credentialprovider.h

Consulte también

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown