Partilhar via

CREDUI_INFOW estrutura (wincred.h)

  • Artigo

A estrutura CREDUI_INFO é usada para passar informações para a função CredUIPromptForCredentials que cria uma caixa de diálogo usada para obter informações de credenciais.

Sintaxe

typedef struct _CREDUI_INFOW {
  DWORD   cbSize;
  HWND    hwndParent;
  PCWSTR  pszMessageText;
  PCWSTR  pszCaptionText;
  HBITMAP hbmBanner;
} CREDUI_INFOW, *PCREDUI_INFOW;

Membros

cbSize

Defina para o tamanho da estrutura de CREDUI_INFO.

hwndParent

Especifica o identificador para a janela pai da caixa de diálogo. A caixa de diálogo é modal em relação à janela pai. Se esse membro estiver NULL, a área de trabalho será a janela pai da caixa de diálogo.

pszMessageText

Ponteiro para uma cadeia de caracteres que contém uma breve mensagem a ser exibida na caixa de diálogo. O comprimento dessa cadeia de caracteres não deve exceder CREDUI_MAX_MESSAGE_LENGTH.

pszCaptionText

Ponteiro para uma cadeia de caracteres que contém o título da caixa de diálogo. O comprimento dessa cadeia de caracteres não deve exceder CREDUI_MAX_CAPTION_LENGTH.

hbmBanner

Bitmap a ser exibido na caixa de diálogo. Se esse membro estiver NULL, um bitmap padrão será usado. O tamanho do bitmap é limitado a 320 x 60 pixels.

Observações

Nota

O cabeçalho wincred.h define CREDUI_INFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho wincred.h