ICredentialProviderCredential::GetStringValue 메서드(credentialprovider.h)

텍스트 필드가 있는 자격 증명에서 텍스트를 검색할 수 있습니다.

구문

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

매개 변수

[in] dwFieldID

형식:DWORD

필드의 식별자입니다.

[out] ppsz

형식: LPWSTR*

로그온 UI 또는 자격 증명 UI로 돌아갈 null로 끝나는 유니코드 문자열이 포함된 메모리에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 선택 사항입니다.

로그온 UI 및 자격 증명 UI에서는 이 메서드를 사용하여 필드의 pszLabel 을 가져옵니다. 이 정보는 CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT및CPFT_PASSWORD_TEXT 필드의 값을 가져오는 데 필요합니다.

자격 증명 공급자 모범 사례

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

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

요구 사항

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