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

Статья
08/22/2023

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

Синтаксис

HRESULT SetUsageScenario(
  [in] CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in] DWORD                              dwFlags
);

Параметры

[in] cpus

Тип: CREDENTIAL_PROVIDER_USAGE_SCENARIO

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

[in] dwFlags

Тип: DWORD

Значение , влияющее на поведение поставщика учетных данных. Это значение может быть побитовой или комбинацией одного или нескольких из следующих значений, определенных в Wincred.h. Дополнительные сведения см. в разделе CredUIPromptForWindowsCredentials .

CREDUIWIN_GENERIC (0x00000001)

0x00000001. Вызывающий объект запрашивает, чтобы поставщик учетных данных вернул имя пользователя и пароль в виде обычного текста. Это значение не может быть объединено с CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. В диалоговом окне появится поле Сохранить проверка.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Следует перечислить только поставщиков учетных данных, поддерживающих входной пакет проверки подлинности. Если поставщики учетных данных не поддерживают входной пакет проверки подлинности, они должны перечислить ноль пользовательских плиток. Это значение не может быть объединено с CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Если поставщик может сериализовать учетные данные, он должен перечислить плитку для этого учетных данных. Другие плитки не должны перечисляться. Поставщики учетных данных должны использовать входные CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION в ICredentialProvider::SetSerialization и dwFlags в ICredentialProvider::SetUsageScenario , чтобы определить, сколько плиток учетных данных необходимо перечислить. Это значение нельзя объединить с CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

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

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Поставщики учетных данных должны перечислить плитку для текущего пользователя, выполнившего вход.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. Диалоговое окно учетных данных должно отображаться на защищенном рабочем столе. Это значение нельзя объединить с CREDUIWIN_GENERIC. Поставщики учетных данных могут спокойно игнорировать этот флаг.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Буферы, передаваемые поставщику, являются 32-разрядными. Буферы, возвращаемые поставщиком, также должны быть 32-разрядными. Это необходимо для WOW64.

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

Тип: HRESULT

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

Этот метод должен возвращать E_NOTIMPL , если вызов завершается, но запрошенный сценарий использования не поддерживается. Этот метод должен возвращать S_OK , если метод выполнен успешно и поддерживается ли сценарий использования.

Требования


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