ICredentialProvider::GetCredentialCount 메서드(credentialprovider.h)

이 자격 증명 공급자에서 사용 가능한 자격 증명 수를 가져옵니다.

구문

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

매개 변수

[out] pdwCount

형식: DWORD*

자격 증명 수를 수신하는 DWORD 값에 대한 포인터입니다.

[out] pdwDefault

형식: DWORD*

기본값으로 사용할 자격 증명의 인덱스를 수신하는 DWORD 값에 대한 포인터입니다. 기본값이 설정되지 않은 경우 이 값을 CREDENTIAL_PROVIDER_NO_DEFAULT 설정해야 합니다.

[out] pbAutoLogonWithDefault

형식: BOOL*

pdwDefault로 식별된 기본 자격 증명을 자동 로그온 시도에 사용해야 하는지 여부를 나타내는 BOOL 값에 대한 포인터입니다. 자동 로그온 시도는 로그온 UI 또는 자격 증명 UI가 공급자의 기본 타일에서 GetSerialization 을 즉시 호출한다는 것을 의미합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 필수입니다.

로그온 UI 또는 자격 증명 UI가 사용자 상호 작용을 위해 준비되면 기본적으로 기본 자격 증명이 선택됩니다. 각 자격 증명 공급자는 기본 자격 증명을 제공하므로 다음 규칙은 pdwDefault 가 포커스를 받을지 또는 자격 증명이 자동으로 로그인되는지 여부를 결정합니다.

• 기본 자격 증명이 이미 지정된 경우 해당 자격 증명은 자동 로그온에 사용할 수 없으며 pdwDefault 가 자동 로그온에 사용되는 경우 pdwDefault 가 기본값으로 사용됩니다.
• pdwDefault가 마지막으로 로그온한 공급자에서 온 것이고 자동 로그온을 사용하는 기본값이 아직 없는 경우 pdwDefault가 기본값으로 사용됩니다.
• 기본값이 지정되지 않은 경우 pdwDefault 가 기본값으로 사용됩니다.

유효한 자격 증명 수가 변경되면 자격 증명 공급자는 Advise에 제공된 ICredentialProviderEvents instance CredentialsChanged를 호출해야 합니다.

자격 증명 공급자 모범 사례

자격 증명 공급자는 로그온을 완료하고 요청을 잠금 해제하기 위해 매우 중요한 사용자 비밀을 처리합니다. 모범 사례로 암호 및 PIN과 같은 비밀 정보는 최대한 주의하여 처리해야 합니다. 자격 증명 공급자 내에서 비밀 정보를 처리하기 위한 적절한 기술은 다음과 같습니다.

• 항상 안전하게 비밀을 삭제합니다. 이렇게 하려면 비밀을 유지하는 데 사용된 메모리를 해제하기 전에 SecureZeroMemory 를 호출합니다.
• 비밀을 사용한 후 즉시 안전하게 삭제합니다.
• 필요한 시간 내에 의도한 용도로 사용되지 않는 경우 비밀을 안전하게 삭제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	credentialprovider.h