Метод ICredentialProviderCredential::GetSubmitButtonValue (credentialprovider.h)

Извлекает идентификатор поля, рядом с которым должна быть помещена кнопка отправки в пользовательском интерфейсе входа. Пользовательский интерфейс учетных данных не вызывает этот метод.

Синтаксис

HRESULT GetSubmitButtonValue(
  [in]  DWORD dwFieldID,
  [out] DWORD *pdwAdjacentTo
);

Параметры

[in] dwFieldID

Тип: DWORD

Идентификатор поля, для которое требуется значение кнопки отправки.

[out] pdwAdjacentTo

Тип: DWORD*

Указатель на значение, которое получает идентификатор поля, рядом с которым должна быть помещена кнопка отправки.

Примечание для разработчиков: Не возвращайте идентификатор поля растрового изображения в этом параметре. Не рекомендуется размещать кнопку отправки рядом с растровым изображением, что может привести к сбою в пользовательском интерфейсе входа.

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

Тип: HRESULT

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

Комментарии

Кнопка отправки не помечена как таковая; это просто универсальный способ ссылки на кнопку, которую вы нажимаете для отправки учетных данных. Обычно кнопка отображается в виде циклической кнопки, содержащей стрелку, указывающую вправо, хотя в последующих выпусках она может измениться. Дополнительные сведения см. в разделе CPFT_SUBMIT_BUTTON.

Не следует скрывать кнопку отправки, если поставщик учетных данных всегда не выполняет автоматическую отправку. В противном случае это может сбить с толку пользователей, так как они не увидят способ отправить свои учетные данные.

Вызовите этот метод при сборке пользовательского интерфейса входа. Пример использования см. в примерах поставщиков учетных данных, включенных в пакет sdk для Windows.

.

Требования

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