ICredentialProviderCredential::GetSubmitButtonValue-Methode (credentialprovider.h)

Artikel
08/22/2023

Ruft den Bezeichner eines Felds ab, das neben der Schaltfläche "Senden" auf der Anmeldebenutzeroberfläche platziert werden soll. Die Benutzeroberfläche für Anmeldeinformationen ruft diese Methode nicht auf.

Syntax

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

Parameter

[in] dwFieldID

Art: DWORD

Der Bezeichner für das Feld, für das ein Übermittlungsschaltflächenwert benötigt wird.

[out] pdwAdjacentTo

Typ: DWORD*

Ein Zeiger auf einen Wert, der die Feld-ID des Felds empfängt, neben dem die Sendeschaltfläche platziert werden soll.

Hinweis für Implementierer: Geben Sie die Feld-ID einer Bitmap in diesem Parameter nicht zurück. Es ist nicht gut, die Schaltfläche "Senden" neben einer Bitmap zu platzieren, und dies kann zu einem Fehler auf der Anmeldebenutzeroberfläche führen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Schaltfläche "Senden" ist nicht als solche gekennzeichnet. dies ist einfach eine generische Möglichkeit, auf die Schaltfläche zu verweisen, auf die Sie klicken, um die Anmeldeinformationen zu übermitteln. Die Schaltfläche wird normalerweise als kreisförmige Schaltfläche angezeigt, die einen Pfeil enthält, der nach rechts zeigt, obwohl sich diese Darstellung in späteren Versionen ändern kann. Weitere Informationen finden Sie unter CPFT_SUBMIT_BUTTON.

Sie sollten die Schaltfläche "Senden" nicht ausblenden, es sei denn, Ihr Anmeldeinformationsanbieter führt immer eine automatische Übermittlung durch. Andernfalls kann dies für die Benutzer verwirrend sein, da sie keine Möglichkeit sehen, ihre Anmeldeinformationen zu übermitteln.

Rufen Sie diese Methode beim Zusammenstellen der Anmeldebenutzeroberfläche auf. Beispiel für die Verwendung finden Sie in den Beispielen für Anmeldeinformationsanbieter, die im Windows Software Development Kit (SDK) enthalten sind.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	credentialprovider.h

Freigeben über