Método ICredentialProviderCredential::GetSubmitButtonValue (credentialprovider.h)

Recupera o identificador de um campo ao qual o botão enviar deve ser colocado ao lado na interface do usuário do Logon. A interface do usuário de credencial não chama esse método.

Sintaxe

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

Parâmetros

[in] dwFieldID

Tipo: DWORD

O identificador do campo para o qual um valor de botão enviar é necessário.

[out] pdwAdjacentTo

Tipo: DWORD*

Um ponteiro para um valor que recebe a ID do campo ao qual o botão enviar deve ser colocado ao lado.

Observação aos implementadores: Não retorne a ID do campo de um bitmap nesse parâmetro. Não é um bom design de interface do usuário colocar o botão enviar ao lado de um bitmap e fazer isso pode causar uma falha na interface do usuário do Logon.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O botão enviar não é rotulado como tal; que é simplesmente uma maneira genérica de se referir ao botão que você clica para enviar as credenciais. O botão normalmente aparece como um botão circular que contém uma seta apontando para a direita, embora essa aparência possa mudar em versões posteriores. Para obter mais informações, consulte CPFT_SUBMIT_BUTTON.

Você não deve ocultar o botão enviar, a menos que seu provedor de credenciais sempre execute o envio automático. Caso contrário, pode ser confuso para os usuários, pois eles não verão uma maneira de enviar suas credenciais.

Chame esse método ao montar a interface do usuário de logon. Por exemplo, use, confira os exemplos de Provedores de Credenciais incluídos no SDK (Software Development Kit) do Windows.

.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	credentialprovider.h