ICredentialProviderCredential::GetStringValue 方法 (credentialprovider.h)
可讓您從具有文字欄位的認證擷取文字。
語法
HRESULT GetStringValue(
[in] DWORD dwFieldID,
[out] LPWSTR *ppsz
);
參數
[in] dwFieldID
類型: DWORD
欄位的識別碼。
[out] ppsz
類型: LPWSTR*
記憶體的指標,其中包含以 Null 結束的 Unicode 字串,以返回登入 UI 或認證 UI。
傳回值
類型: 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 |