Интерфейс ICredentialProviderCredential2 (credentialprovider.h)
Расширяет интерфейс ICredentialProviderCredential, добавляя метод, который получает идентификатор безопасности (SID) пользователя. Учетные данные связаны с этим пользователем и могут быть сгруппированы под плиткой пользователя.
Наследование
Интерфейс ICredentialProviderCredential2 наследуется от ICredentialProviderCredential. ICredentialProviderCredential2 также имеет следующие типы элементов:
Методы
Интерфейс ICredentialProviderCredential2 содержит следующие методы.
| ICredentialProviderCredential2::GetUserSid Извлекает идентификатор безопасности (SID) пользователя, связанного с данными учетными данными. |
Комментарии
Этот класс необходим для создания поставщика учетных данных версии 2. Поставщики учетных данных версии 2 предоставляют пользователю персонализированный интерфейс входа. Это происходит, когда поставщик учетных данных сообщает пользовательскому интерфейсу входа, какие параметры входа доступны для пользователя. Рекомендуется, чтобы новые поставщики учетных данных были поставщиками учетных данных версии 2.
Чтобы создать экземпляр ICredentialProviderCredential2 , функция GetUserSid должна возвращать допустимый идентификатор безопасности. Допустимый определяется возвращаемым идентификатором безопасности для одного из пользователей, перечисляемых в пользовательском интерфейсе входа.
Полезным инструментом для получения доступных пользователей и определения того, с какими из них вы хотите связать, является объект ICredentialProviderUserArray . Этот объект содержит список объектов ICredentialProviderUser, которые можно запрашивать для получения сведений о пользователях, которые будут перечислены. Например, вы можете получить идентификатор безопасности пользователя или имя пользователя с помощью GetStringValue с переданным параметром PKEY_Identity_PrimarySid или PKEY_Identity_USerName соответственно. Вы даже можете отфильтровать результаты с помощью SetProviderFilter , чтобы отобразить только подмножество доступных пользователей.
Использование ICredentialProviderUserArray является необязательным, но это удобный способ получения необходимых сведений для получения допустимых значений sid. Чтобы получить список пользователей, которые будут перечислены в пользовательском интерфейсе Logon, реализуйте интерфейс ICredentialProviderSetUserArray , чтобы получить объект ICredentialProviderUserArray из SetUserArray. Пользовательский интерфейс входа вызывает SetUserArray перед GetCredentialCount, поэтому объект ICredentialProviderUserArray готов, когда поставщик учетных данных возвращает учетные данные.
Поставщик учетных данных версии 2 представлен значком, отображаемым под ссылкой "Параметры входа". Чтобы предоставить значок поставщика учетных данных, определите CREDENTIAL_PROVIDER_FIELD_TYPECPFT_TILE_IMAGE в самом учетных данных. Затем убедитесь, что guidFieldTypeCREDENTIAL_PROVIDER_FIELD_DESCRIPTOR имеет значение CPFG_CREDENTIAL_PROVIDER_LOGO. Рекомендуемый размер значка — 72 на 72 пикселя.
Аналогично указанию значка для поставщика учетных данных, можно также указать текстовую строку для идентификации поставщика учетных данных. Эта строка отображается во всплывающем окне при наведении указателя мыши на значок. Для этого определите CREDENTIAL_PROVIDER_FIELD_TYPECPFT_SMALL_TEXT в самих учетных данных. Затем убедитесь, что guidFieldTypeCREDENTIAL_PROVIDER_FIELD_DESCRIPTOR имеет значение CPFG_CREDENTIAL_PROVIDER_LABEL. Эта строка должна дополнять описанный выше значок поставщика учетных данных и быть достаточно описательным, чтобы пользователи понимали, что это такое. Например, описание поставщика паролей рисунков — "Пароль рисунка".
Когда следует реализовать
Реализуйте этот интерфейс, чтобы связать плитки учетных данных с плитками определенных пользователей в пользовательском интерфейсе входа.Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | credentialprovider.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по