SspiPromptForCredentialsA-Funktion (sspi.h)
Ermöglicht einer SSPI-Anwendung (Security Support Provider Interface ), einen Benutzer zur Eingabe von Anmeldeinformationen aufzufordern.
Syntax
unsigned long SEC_ENTRY SspiPromptForCredentialsA(
[in] PCSTR pszTargetName,
[in] PCREDUI_INFOA pUiInfo,
[in] unsigned long dwAuthError,
[in] PCSTR pszPackage,
[in] PSEC_WINNT_AUTH_IDENTITY_OPAQUE pInputAuthIdentity,
[out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE *ppAuthIdentity,
[in, out, optional] int *pfSave,
[in] unsigned long dwFlags
);
Parameter
[in] pszTargetName
Der Name des zu verwendenden Ziels.
[in] pUiInfo
Ein Zeiger auf eine CREDUI_INFO-Struktur , die Informationen zum Anpassen der Darstellung des Dialogfelds enthält, das von dieser Funktion angezeigt wird.
Wenn der hwndParent-Member der CREDUI_INFO-Struktur nicht NULL ist, zeigt diese Funktion ein modales Dialogfeld an, das auf dem übergeordneten Fenster zentriert ist.
Wenn der hwndParent-Member der CREDUI_INFO-StrukturNULL ist, zeigt die Funktion ein Dialogfeld an, das auf dem Bildschirm zentriert ist.
Diese Funktion ignoriert den hbmBanner-Member der CREDUI_INFO-Struktur .
[in] dwAuthError
Ein in Winerror.h definierter Windows-Fehlercode, der im Dialogfeld angezeigt wird. Wenn zuvor gesammelte Anmeldeinformationen ungültig waren, verwendet der Aufrufer diesen Parameter, um die Fehlermeldung von der API zu übergeben, die die Anmeldeinformationen (z. B. Winlogon) gesammelt hat, an diese Funktion. Die entsprechende Fehlermeldung wird formatiert und im Dialogfeld angezeigt. Legen Sie den Wert dieses Parameters auf Null fest, um keine Fehlermeldung anzuzeigen.
[in] pszPackage
Der Name des zu verwendenden Sicherheitspakets.
[in] pInputAuthIdentity
Eine Identitätsstruktur, die zum Auffüllen von Anmeldeinformationsfeldern im Dialogfeld verwendet wird. Um die Anmeldeinformationsfelder leer zu lassen, legen Sie den Wert dieses Parameters auf NULL fest.
[out] ppAuthIdentity
Eine Identitätsstruktur, die die Von dieser Funktion erfassten Anmeldeinformationen darstellt.
Wenn Sie die Verwendung dieser Struktur abgeschlossen haben, geben Sie sie frei, indem Sie die Funktion SspiFreeAuthIdentity aufrufen.
[in, out, optional] pfSave
Ein Zeiger auf einen booleschen Wert, der bei der Eingabe angibt, ob das Kontrollkästchen Speichern im Von dieser Funktion angezeigten Dialogfeld aktiviert ist. Bei der Ausgabe gibt der Wert dieses Parameters an, ob das Kontrollkästchen Speichern aktiviert wurde, als der Benutzer im Dialogfeld auf die Schaltfläche Senden geklickt hat. Legen Sie diesen Parameter auf NULL fest, um das Kontrollkästchen Speichern zu ignorieren.
Dieser Parameter wird ignoriert, wenn das flag CREDUIWIN_CHECKBOX im dwFlags-Parameter nicht festgelegt ist.
[in] dwFlags
Flags, die das Verhalten dieser Funktion bestimmen. Das folgende Flag ist derzeit definiert.
Wert | Bedeutung |
---|---|
|
Der Wert des pfSave-Parameters wird ignoriert, und die von dieser Funktion gesammelten Anmeldeinformationen werden nicht gespeichert.
Windows 7 und Windows Server 2008 R2: Der Wert des pfSave-Parameters wird ignoriert, und die von dieser Funktion gesammelten Anmeldeinformationen werden nicht gespeichert. Nur der Name dieses möglichen Werts wurde SSPIPFC_SAVE_CRED_BY_CALLER. |
|
Der Wert gibt an, dass die Anbieter von Kennwort und intelligenten Karte Anmeldeinformationen dem Benutzer das Kontrollkästchen "Meine Anmeldeinformationen speichern" nicht anzeigen. Die SspiPromptForCredentials-Funktion übergibt diesen Flagwert SSPIPFC_NO_CHECKBOX im parameter pvInAuthBuffer der CredUIPromptForWindowsCredentials-Funktion . |
Rückgabewert
Wenn die Funktion erfolgreich ist, wird SEC_E_OK zurückgegeben.
Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich null zurückgegeben.
Hinweise
Hinweis
Der sspi.h-Header definiert SspiPromptForCredentials als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | sspi.h |
Bibliothek | Credui.lib |
DLL | Credui.dll |