CredUIStoreSSOCredW function

The CredUIStoreSSOCredW function stores a single logon credential.

Syntax


DWORD CredUIStoreSSOCredW(
  _In_ PCWSTR pszRealm,
  _In_ PCWSTR pszUsername,
  _In_ PCWSTR pszPassword,
  _In_ BOOL   bPersist
);

Parameters

pszRealm [in]

Pointer to a null-terminated string that specifies the realm. If this parameter is NULL, the default realm is used.

pszUsername [in]

Pointer to a null-terminated string that specifies the user's name.

pszPassword [in]

Pointer to a null-terminated string that specifies the user's password. When you have finished using the password, clear the password from memory by calling the SecureZeroMemory function. For more information about protecting passwords, see Handling Passwords.

bPersist [in]

Boolean value that specifies whether the credentials are persisted. If this value is TRUE, the credentials are persisted. If this value is FALSE, the credentials are not persisted.

Return value

The return value is a DWORD. A return value of ERROR_SUCCESS indicates the function was successful.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinCred.h

Library

Credui.lib

DLL

Credui.dll

See also

CredUIReadSSOCredW

 

 

Show: