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

  • Artigo

Define as características de serialização do provedor de credenciais.

Sintaxe

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

Parâmetros

[in] pcpcs

Tipo: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Um ponteiro para uma estrutura CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION que armazena as características de serialização do provedor de credenciais.

Retornar valor

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. Ele aceita uma credencial e determina se pcpcs era uma credencial parcial ou completa. Se for uma credencial parcial, ela estará incompleta ou foi passada com a finalidade de exibir algumas informações para o usuário. Se for uma credencial completa, ela deverá ser serializada e enviada. Use os membros do CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION e os sinalizadores passados em SetUsageScenario para determinar como lidar com a entrada. A responsabilidade está no provedor de credenciais para verificar a integridade da entrada. A interface do usuário de credencial e a interface do usuário do Logon não executam nenhuma verificação na estrutura antes de passá-la para o provedor de credenciais.

SetSerialization é sempre chamado após SetUsageScenario. A interface do usuário de logon também chama SetSerialization quando um filtro retorna uma credencial por meio de UpdateRemoteCredential. Ele não usa esse método ao enumerar novamente blocos devido a uma chamada para CredentialsChanged. A interface do usuário de credencial chama SetSerialization quando uma credencial de entrada é suídrica por um aplicativo.

A interface do usuário de credencial impõe as regras a seguir com base no dwFlags para essa instância do provedor de conteúdo definida quando SetUsageScenario foi chamado.

  • Se os sinalizadores incluirem CREDUIWIN_IN_CRED_ONLY, todos os provedores de credenciais que retornam S_OK estarão habilitados.
  • Se os sinalizadores incluirem CREDUIWIN_AUTHPACKAGE_ONLY, todos os provedores de credenciais que retornam um status de êxito serão habilitados.
  • Se nenhum desses sinalizadores estiver incluído, a interface do usuário de credencial seguirá a mesma lógica que a interface do usuário de Logon e todos os provedores de credenciais que implementam o CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_REDUI serão habilitados independentemente do valor de status retornado.
Os provedores de credenciais que implementam uma CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON e retornam uma falha desse método ainda serão habilitados.

Requisitos

Requisito Valor
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