Skip to content

Latest commit

 

History

History
88 lines (68 loc) · 3.58 KB

nf-credentialprovider-icredentialprovidercredential-setstringvalue.md

File metadata and controls

88 lines (68 loc) · 3.58 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:credentialprovider.ICredentialProviderCredential.SetStringValue
ICredentialProviderCredential::SetStringValue (credentialprovider.h)
Enables a Logon UI or Credential UI to update the text for a CPFT_EDIT_TEXT fields as the user types in them.
ICredentialProviderCredential interface [Windows Shell]
SetStringValue method
ICredentialProviderCredential.SetStringValue
ICredentialProviderCredential::SetStringValue
SetStringValue
SetStringValue method [Windows Shell]
SetStringValue method [Windows Shell]
ICredentialProviderCredential interface
credentialprovider/ICredentialProviderCredential::SetStringValue
shell.ICredentialProviderCredential_SetStringValue
shell_ICredentialProviderCredential_SetStringValue
shell\ICredentialProviderCredential_SetStringValue.htm
shell
ea2007b9-fff1-4cd2-8656-61ec050a8e96
12/05/2018
ICredentialProviderCredential interface [Windows Shell],SetStringValue method, ICredentialProviderCredential.SetStringValue, ICredentialProviderCredential::SetStringValue, SetStringValue, SetStringValue method [Windows Shell], SetStringValue method [Windows Shell],ICredentialProviderCredential interface, credentialprovider/ICredentialProviderCredential::SetStringValue, shell.ICredentialProviderCredential_SetStringValue, shell_ICredentialProviderCredential_SetStringValue
credentialprovider.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Credentialprovider.idl
Windows
19H1
ICredentialProviderCredential::SetStringValue
credentialprovider/ICredentialProviderCredential::SetStringValue
c++
APIRef
kbSyntax
COM
Credentialprovider.h
ICredentialProviderCredential.SetStringValue

ICredentialProviderCredential::SetStringValue

-description

Enables a Logon UI or Credential UI to update the text for a CPFT_EDIT_TEXT fields as the user types in them.

-parameters

-param dwFieldID [in]

Type: DWORD

The identifier for the field that needs to be updated.

-param psz [in]

Type: LPCWSTR

A pointer to a buffer containing the new text.

-returns

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

This method is optional.

Credential Provider Best Practices

Credential providers handle extremely sensitive user secrets in order to complete logon and unlock requests. As a best practice, secret information such as passwords and PINs should be handled with the utmost care. Proper techniques for handling secret information within a credential provider are:
  • Always securely discard secrets. To do this, call SecureZeroMemory before freeing the memory used to hold any secret.
  • Securely discard secrets promptly after they are used.
  • Securely discard secrets if they are not used for their intended purpose within an expected amount of time.