Windows Dev Center

ICredentialProvider::GetCredentialCount method

Gets the number of available credentials under this credential provider.

Syntax


HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Parameters

pdwCount [out]

Type: DWORD*

A pointer to a DWORD value that receives the count of credentials.

pdwDefault [out]

Type: DWORD*

A pointer to a DWORD value that receives the index of the credential to be used as the default. If no default value has been set, this value returns CREDENTIAL_PROVIDER_NO_DEFAULT.

pbAutoLogonWithDefault [out]

Type: BOOL*

A pointer to a BOOL value indicating that the default credential identified by pdwDefault should be used for an autologon attempt.

Return value

Type: HRESULT

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

Remarks

This method is required.

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.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Credentialprovider.h

IDL

Credentialprovider.idl

 

 

Community Additions

ADD
Show:
© 2015 Microsoft