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 가 기본값으로 사용됩니다.
자격 증명 공급자 모범 사례
자격 증명 공급자는 로그온을 완료하고 요청을 잠금 해제하기 위해 매우 중요한 사용자 비밀을 처리합니다. 모범 사례로 암호 및 PIN과 같은 비밀 정보는 최대한 주의하여 처리해야 합니다. 자격 증명 공급자 내에서 비밀 정보를 처리하기 위한 적절한 기술은 다음과 같습니다.- 항상 안전하게 비밀을 삭제합니다. 이렇게 하려면 비밀을 유지하는 데 사용된 메모리를 해제하기 전에 SecureZeroMemory 를 호출합니다.
- 비밀을 사용한 후 즉시 안전하게 삭제합니다.
- 필요한 시간 내에 의도한 용도로 사용되지 않는 경우 비밀을 안전하게 삭제합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | credentialprovider.h |