Метод ICredentialProvider::GetCredentialCount (credentialprovider.h)

  • Статья

Возвращает количество доступных учетных данных в этом поставщике учетных данных.

Синтаксис

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Параметры

[out] pdwCount

Тип: DWORD*

Указатель на значение DWORD , получающее количество учетных данных.

[out] pdwDefault

Тип: DWORD*

Указатель на значение DWORD , которое получает индекс учетных данных, используемых в качестве значения по умолчанию. Если значение по умолчанию не задано, это значение должно быть равно CREDENTIAL_PROVIDER_NO_DEFAULT.

[out] pbAutoLogonWithDefault

Тип: BOOL*

Указатель на значение BOOL , указывающее, следует ли использовать учетные данные по умолчанию, определяемые pdwDefault , для попытки автоматического входа. Попытка автоматического входа означает, что пользовательский интерфейс входа или пользовательский интерфейс учетных данных немедленно вызовет GetSerialization на плитке поставщика по умолчанию.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод является обязательным.

Когда пользовательский интерфейс входа или пользовательский интерфейс учетных данных готов к взаимодействию с пользователем, по умолчанию выбираются учетные данные по умолчанию. Так как каждый поставщик учетных данных предоставляет учетные данные по умолчанию, следующие правила определяют, получит ли pdwDefault фокус или учетные данные будут автоматически вошли в систему.

  • Если учетные данные по умолчанию уже указаны, эти учетные данные не предназначены для автоматического входа, а pdwDefault используется для автоматического входа, то pdwDefault будет использоваться по умолчанию.
  • Если pdwDefault является последним вошедшего в систему поставщика и по умолчанию с автоматическим входом еще нет, то pdwDefault будет использоваться в качестве значения по умолчанию.
  • Если значение по умолчанию не указано, в качестве значения по умолчанию будет использоваться pdwDefault .
Если количество допустимых учетных данных изменится, поставщик учетных данных должен вызвать CredentialsChanged для экземпляра ICredentialProviderEvents , предоставленного в Совете.

Рекомендации по поставщику учетных данных

Поставщики учетных данных обрабатывают очень конфиденциальные секреты пользователей для выполнения запросов на вход и разблокировку. Как правило, секретные сведения, такие как пароли и ПИН-коды, следует обрабатывать с максимальной осторожностью. Правильные методы обработки секретных сведений в поставщике учетных данных:
  • Всегда безопасно отбрасывать секреты. Для этого вызовите SecureZeroMemory перед освобождением памяти, используемой для хранения секрета.
  • Безопасно отменяйте секреты сразу после их использования.
  • Безопасно отменяйте секреты, если они не используются по назначению в течение ожидаемого времени.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header credentialprovider.h