CREDUI_INFOA結構 (wincred.h)

  • 發行項

CREDUI_INFO結構可用來將資訊傳遞至CredUIPromptForCredentials函式，以建立用來取得認證資訊的對話方塊。

語法

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

成員

cbSize

設定為CREDUI_INFO結構的大小。

hwndParent

指定對話方塊之父視窗的控制碼。 對話方塊是相對於父視窗的強制回應。 如果這個成員是 Null，桌面是對話方塊的父視窗。

pszMessageText

字串的指標，其中包含要顯示在對話方塊中的簡短訊息。 此字串的長度不應超過CREDUI_MAX_MESSAGE_LENGTH。

pszCaptionText

包含對話方塊標題的字串指標。 此字串的長度不應超過CREDUI_MAX_CAPTION_LENGTH。

hbmBanner

要顯示在對話方塊中的點陣圖。 如果這個成員是 Null，則會使用預設點陣圖。 點陣圖大小限制為 320x60 圖元。

備註

注意

wincred.h 標頭會將CREDUI_INFO定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 wincred.h