Método IWRdsProtocolConnection2::GetSerializedUserCredential (wtsprotocol.h)

Retorna uma credencial de usuário serializada.

Sintaxe

HRESULT GetSerializedUserCredential(
    [out] WRDS_SERIALIZED_USER_CREDENTIAL** userCredential);

Sintaxe

HRESULT GetSerializedUserCredential(
  [out] WRDS_SERIALIZED_USER_CREDENTIAL **userCredential
);

Parâmetros

[out] userCredential

Recebe um ponteiro para uma instância de WTS_SERIALIZED_USER_CREDENTIAL que contém a credencial serializada se a função for bem-sucedida. Para liberar a memória alocada, o serviço Serviços de Área de Trabalho Remota chama a função WTSFreeMemoryEx e passa WTSTypeSerializedUserCredential para o parâmetro WTSTypeClass . As implementações de protocolo podem transferir a propriedade da credencial obtida usando WTSCloudAuthConvertAssertionToSerializedUserCredential (recomendado) após a qual não devem mais usar a credencial. Como alternativa, as implementações de protocolo podem usar WTSCloudAuthDuplicateSerializedUserCredential* para duplicar as credenciais serializadas obtidas do WTSCloudAuthConvertAssertionToSerializedUserCredential.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK. Se a função falhar, ela retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

Se o protocolo retornar um código de erro HRESULT nesse método e em **IWRdsProtocolConnection::GetUserCredentials, o WinLogon exibirá uma tela de logon para solicitar credenciais. Se o protocolo retornar S_OK, as credenciais serão passadas para o WinLogon para fazer logon no usuário.

Requirements