GetCredentials 方法可取得應用程式的使用者憑證資料。
語法
HRESULT GetCredentials(
BSTR bstrApplicationName,
LONG lFlags,
BSTR* pbstrExternalUserName,
SAFEARRAY credentials
);
Function GetCredentials(
bstrApplicationName As String,
lFlags As Long,
pbstrExternalUserName As String
)
As String
參數
bstrApplicationName
[在]指定應用程式名稱的字串。 此參數不能是 NULL、空字串，或包含空格。 應用程式名稱不區分大小寫，但大小寫會被保留。 例如，ABC、abc 和 AbC 被視為同一個應用程式。
bstrApplicationName
[在]指定應用程式名稱的字串。 此參數不能是 NULL、空字串，或包含空格。 應用程式名稱不區分大小寫，但大小寫會被保留。 例如，ABC、abc 和 AbC 被視為同一個應用程式。
lFlags
[在]長整數，指定要設定的旗標。 使用SSO_FLAG_REFRESH表示應該繞過憑證快取。
lFlags
[在]長篇說明要設定哪些旗標。 使用SSO_FLAG_REFRESH表示應該繞過憑證快取。
pbstrExternalUserName
[出]指標指向接收外部使用者名稱的字串。
pbstrExternalUserName
[出]接收外部使用者名稱的字串。
credentials
[出]字串陣列會接收憑證。
傳回值
此方法回傳一個 HRESULT，表示是否成功完成。 更多細節請參閱誤差值章節。
字串陣列會接收憑證。
誤差值
此方法回傳包含下表中其中一個值的 HRESULT。
此方法透過將全域 Err 物件的 Number 屬性設為下表中的某一個值來表示錯誤。
| 價值 | 說明 |
|---|---|
| S_OK | 此方法已成功。 |
| E_ACCESSDENIED | 來電者無法進入。 |
| E_INVALIDARG | 偵測到無效的參數。 |
備註
要使用此方法，您必須是應用程式使用者。 你只能取回自己的憑證。
要求
平台： Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11 及 Windows 10