CREDUI_INFOA-Struktur (wincred.h)

Artikel
08/27/2023

Die CREDUI_INFO-Struktur wird verwendet, um Informationen an die CredUIPromptForCredentials-Funktion zu übergeben, die ein Dialogfeld zum Abrufen von Anmeldeinformationen erstellt.

Syntax

typedef struct _CREDUI_INFOA {
  DWORD   cbSize;
  HWND    hwndParent;
  PCSTR   pszMessageText;
  PCSTR   pszCaptionText;
  HBITMAP hbmBanner;
} CREDUI_INFOA, *PCREDUI_INFOA;

Member

cbSize

Legen Sie die Größe der CREDUI_INFO-Struktur fest.

hwndParent

Gibt das Handle für das übergeordnete Fenster des Dialogfelds an. Das Dialogfeld ist in Bezug auf das übergeordnete Fenster modal. Wenn dieses Element NULL ist, ist der Desktop das übergeordnete Fenster des Dialogfelds.

pszMessageText

Zeiger auf eine Zeichenfolge, die eine kurze Meldung enthält, die im Dialogfeld angezeigt werden soll. Die Länge dieser Zeichenfolge sollte CREDUI_MAX_MESSAGE_LENGTH nicht überschreiten.

pszCaptionText

Zeiger auf eine Zeichenfolge, die den Titel für das Dialogfeld enthält. Die Länge dieser Zeichenfolge sollte CREDUI_MAX_CAPTION_LENGTH nicht überschreiten.

hbmBanner

Bitmap, die im Dialogfeld angezeigt werden soll. Wenn dieses Element NULL ist, wird eine Standard-Bitmap verwendet. Die Bitmapgröße ist auf 320 x 60 Pixel beschränkt.

Hinweise

Hinweis

Der wincred.h-Header definiert CREDUI_INFO 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincred.h

Share via