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

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

Syntax

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

Parámetros

[in] pcpcs

Tipo: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Puntero a una estructura de 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 HRESULT .

Observaciones

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 proporcionado una credencial de entrada.

La interfaz de usuario de credenciales aplica las siguientes reglas basadas en dwFlags para esta instancia de 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 incluye 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 CPUS_REDUI de CREDENTIAL_PROVIDER_USAGE_SCENARIO se habilitarán independientemente del valor de estado devuelto.

Requisitos