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

  • Artículo

Establece las características de serialización del proveedor de credenciales.

Sintaxis

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

Parámetros

[in] pcpcs

Tipo: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Puntero a una estructura CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION que almacena las características de serialización del proveedor de credenciales.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método es necesario. Acepta una credencial y determina si pcpcs era parcial o completa. Si es una credencial parcial, está incompleta o se pasó para mostrar información al usuario. Si es una credencial completa, se debe serializar y enviar. Use los miembros del CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION y las marcas pasadas en SetUsageScenario para determinar cómo controlar la entrada. La responsabilidad está en el proveedor de credenciales para comprobar la integridad de la entrada. La interfaz de usuario de credenciales y la interfaz de usuario de inicio de sesión no realizan ninguna comprobación en la estructura antes de pasarla al proveedor de credenciales.

Siempre se llama a SetSerialization después de SetUsageScenario. La interfaz de usuario de inicio de sesión también llama a SetSerialization cuando un filtro devuelve una credencial a través de UpdateRemoteCredential. No usa este método al volver a enumerar iconos debido a una llamada a CredentialsChanged. La interfaz de usuario de credenciales llama a SetSerialization cuando una aplicación ha rellenado una credencial de entrada.

La interfaz de usuario de credenciales aplica las siguientes reglas basadas en dwFlags para esta instancia del proveedor de contenido definida cuando se llamó a SetUsageScenario .

  • Si las marcas incluyen CREDUIWIN_IN_CRED_ONLY, todos los proveedores de credenciales que devuelven S_OK están habilitados.
  • Si las marcas incluyen CREDUIWIN_AUTHPACKAGE_ONLY, todos los proveedores de credenciales que devuelven un estado correcto están habilitados.
  • Si no se incluyen ninguna de esas marcas, la interfaz de usuario de credenciales sigue la misma lógica que la interfaz de usuario de inicio de sesión y todos los proveedores de credenciales que implementan el CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUI se habilitarán independientemente del valor de estado devuelto.
Los proveedores de credenciales que implementan una CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON y devuelven un error de este método seguirán estando habilitados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h