Método ICredentialProvider::SetUsageScenario (credentialprovider.h)

Define os cenários para os quais o provedor de credenciais é válido. Chamado sempre que o provedor de credenciais é inicializado.

Sintaxe

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

Parâmetros

[in] cpus

Tipo: CREDENTIAL_PROVIDER_USAGE_SCENARIO

O cenário em que o provedor de credenciais foi criado. Esse é o cenário de uso que precisa ter suporte. Consulte os Comentários para obter mais informações.

[in] dwFlags

Tipo: DWORD

Um valor que afeta o comportamento do provedor de credenciais. Esse valor pode ser uma combinação OR bit a bit de um ou mais dos valores a seguir definidos em Wincred.h. Consulte CredUIPromptForWindowsCredentials para obter mais informações.

CREDUIWIN_GENERIC (0x00000001)

0x00000001. O chamador está solicitando que o provedor de credenciais retorne o nome de usuário e a senha em texto sem formatação. Esse valor não pode ser combinado com CREDUIWIN_SECURE_PROMPT.

CREDUIWIN_CHECKBOX (0x00000002)

0x00000002. A caixa Salvar marcar é exibida na caixa de diálogo.

CREDUIWIN_AUTHPACKAGE_ONLY (0x00000010)

0x00000010. Somente provedores de credenciais que dão suporte ao pacote de autenticação de entrada devem ser enumerados. Se os provedores de credenciais não derem suporte ao pacote de autenticação de entrada, eles deverão enumerar blocos de usuário zero. Esse valor não pode ser combinado com CREDUIWIN_IN_CRED_ONLY.

CREDUIWIN_IN_CRED_ONLY (0x00000020)

0x00000020. Se o provedor puder serializar as credenciais, ele deverá enumerar um bloco para essa credencial. Nenhum outro bloco deve ser enumerado. Os provedores de credenciais devem usar o CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION de entrada em ICredentialProvider::SetSerialization e dwFlags em ICredentialProvider::SetUsageScenario para determinar quantos blocos de credencial enumerar. Esse valor não pode ser combinado com CREDUIWIN_AUTHPACKAGE_ONLY.

CREDUIWIN_ENUMERATE_ADMINS (0x00000100)

0x00000100. Os provedores de credenciais devem enumerar somente os administradores. Esse valor destina-se apenas a fins de UAC. Recomendamos que os chamadores externos não definam esse sinalizador.

CREDUIWIN_ENUMERATE_CURRENT_USER (0x00000200)

0x00000200. Os provedores de credenciais devem enumerar um bloco para o usuário conectado no momento.

CREDUIWIN_SECURE_PROMPT (0x00001000)

0x00001000. A caixa de diálogo de credencial deve ser exibida na área de trabalho segura. Esse valor não pode ser combinado com CREDUIWIN_GENERIC. Os implementadores do provedor de credenciais podem ignorar esse sinalizador com segurança.

CREDUIWIN_PACK_32_WOW (0x10000000)

0x10000000. Os buffers passados para o provedor são de 32 bits. Os buffers retornados do provedor também devem ser de 32 bits. Isso é necessário para WOW64.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é necessário e permite que o provedor de credenciais indique como ele será usado.

Esse método deverá retornar E_NOTIMPL se a chamada for concluída, mas não houver suporte para o cenário de uso solicitado. Esse método deverá retornar S_OK se o método for bem-sucedido e houver suporte para o cenário de uso.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	credentialprovider.h