Compartilhar via


ISocialSession2::LogonCached

Faz logon no site da rede social usando credenciais armazenadas em cache.

HRESULT _stdcall LogonCached([in] BSTR connectIn, [in] BSTR userName, [in] BSTR password, [out] BSTR connectOut);

Parâmetros

Connectin

[in] Uma cadeia de caracteres que pode estar vazia ou contém as credenciais de logon, dependendo do contexto em que o OSC está chamando LogonCached.

userName

[in] Uma cadeia de caracteres que contém o nome de usuário.

senha

[in] Uma cadeia de caracteres que contém a senha do usuário.

connectOut

[out] Uma cadeia de caracteres opaca que contém credenciais.

Comentários

Esse método será chamado para autenticação somente se useLogonCached for definido como true nos recursos XML retornados por ISocialProvider::GetCapabilities.

O OSC (Outlook Social Connector) chama LogonCached e passa uma cadeia de caracteres vazia para conexãoIn e cadeias de caracteres userName e senha não vazias. O provedor usa userName e senha para fazer logon na rede social e retorna um parâmetro connectOut opaco para o OSC se a autenticação for bem-sucedida. Se a autenticação falhar, o provedor retornará o erro OSC_E_LOGON_FAILURE para o OSC.

O parâmetro connectOut é uma cadeia de caracteres opaca para o OSC e é passado para o parâmetro connectIn em tentativas subsequentes do OSC de fazer logon na rede social. O provedor deve colocar todas as credenciais na cadeia de caracteres connectOut que o provedor deseja que o OSC armazene entre conexões. O OSC não interpreta a cadeia de caracteres no connectOut e criptografa a cadeia de caracteres para fins de segurança antes de armazená-la no registro do Windows.

Confira também