Metodo ICredentialProviderCredential::GetSubmitButtonValue (credentialprovider.h)

Articolo
08/22/2023

Recupera l'identificatore di un campo a cui deve essere posizionato il pulsante di invio accanto all'interfaccia utente di accesso. L'interfaccia utente delle credenziali non chiama questo metodo.

Sintassi

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

Parametri

[in] dwFieldID

Tipo: DWORD

L'identificatore per il campo per cui è necessario un valore del pulsante di invio.

[out] pdwAdjacentTo

Tipo: DWORD*

Puntatore a un valore che riceve l'ID campo del campo a cui deve essere posizionato il pulsante di invio.

Nota per gli implementatori: Non restituire l'ID campo di una bitmap in questo parametro. Non è una buona progettazione dell'interfaccia utente posizionare il pulsante di invio accanto a una bitmap e in questo modo può causare un errore nell'interfaccia utente di accesso.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il pulsante invia non è etichettato come tale; che è semplicemente un modo generico per fare riferimento al pulsante che si fa clic per inviare le credenziali. Il pulsante viene visualizzato normalmente come pulsante circolare che contiene una freccia che punta a destra, anche se questo aspetto potrebbe cambiare nelle versioni successive. Per altre informazioni, vedere CPFT_SUBMIT_BUTTON.

Non è consigliabile nascondere il pulsante di invio, a meno che il provider di credenziali non esegua sempre l'invio automatico. In caso contrario, gli utenti potrebbero creare confusione perché non vedranno un modo per inviare le proprie credenziali.

Chiamare questo metodo durante l'assemblaggio dell'interfaccia utente di accesso. Ad esempio, vedere gli esempi di provider di credenziali inclusi in Windows Software Development Kit (SDK).

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	credentialprovider.h

Condividi tramite