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

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.

Valor de retorno

Tipo: HRESULT

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

Observações

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 ao 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 da 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 renumerar blocos devido a uma chamada para CredentialsChanged. A interface do usuário da credencial chama SetSerialization quando uma credencial de entrada é fornecida 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 da 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.

Requirements