ICredentialProviderCredential::GetSubmitButtonValue メソッド (credentialprovider.h)

ログオン UI の横に送信ボタンを配置する必要があるフィールドの識別子を取得します。 資格情報 UI では、このメソッドは呼び出されません。

構文

HRESULT GetSubmitButtonValue(
  [in]  DWORD dwFieldID,
  [out] DWORD *pdwAdjacentTo
);

パラメーター

[in] dwFieldID

型: DWORD

送信ボタンの値が必要なフィールドの識別子。

[out] pdwAdjacentTo

型: DWORD*

送信ボタンの横に配置するフィールドのフィールド ID を受け取る値へのポインター。

実装者への注意: このパラメーターでは、ビットマップのフィールド ID を返さないでください。 ビットマップの横に送信ボタンを配置するのは適切な UI 設計ではなく、ログオン UI でエラーが発生する可能性があります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

[送信] ボタンにはラベルが付けされていません。これは、クリックして資格情報を送信するボタンを参照する一般的な方法です。 ボタンは通常、右を指す矢印を含む円形のボタンとして表示されますが、この外観は後のリリースで変更される可能性があります。 詳細については、「 CPFT_SUBMIT_BUTTON」を参照してください。

資格情報プロバイダーが常に自動送信を実行しない限り、送信ボタンを非表示にしないでください。 そうしないと、資格情報を送信する方法が表示されないため、ユーザーに混乱を招く可能性があります。

ログオン UI をアセンブルするときに、このメソッドを呼び出します。 使用例については、Windows ソフトウェア開発キット (SDK) に含まれている資格情報プロバイダーのサンプルを参照してください。

.

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	credentialprovider.h