struttura CREDENTIAL_ATTRIBUTEA (wincred.h)

La struttura CREDENTIAL_ATTRIBUTE contiene un attributo definito dall'applicazione delle credenziali. Un attributo è una coppia di parole chiave-valore. Spetta all'applicazione definire il significato dell'attributo.

Sintassi

typedef struct _CREDENTIAL_ATTRIBUTEA {
  LPSTR  Keyword;
  DWORD  Flags;
  DWORD  ValueSize;
  LPBYTE Value;
} CREDENTIAL_ATTRIBUTEA, *PCREDENTIAL_ATTRIBUTEA;

Membri

Keyword

Nome dell'attributo specifico dell'applicazione. I nomi devono essere nel formato <CompanyName>_<Name>.

Questo membro non può essere più lungo di CRED_MAX_STRING_LENGTH (256) caratteri.

Flags

Identifica le caratteristiche dell'attributo delle credenziali. Questo membro è riservato e deve essere originariamente inizializzato come zero e non modificato in altro modo per consentire miglioramenti futuri.

ValueSize

Lunghezza valore in byte. Questo membro non può essere maggiore di CRED_MAX_VALUE_SIZE (256).

Value

Dati associati all'attributo . Per convenzione, se Valore è una stringa di testo, Valore non deve includere il carattere zero finale e deve essere in UNICODE.

È previsto che le credenziali siano portabili. L'applicazione deve assicurarsi che i dati in valore siano portabili. È responsabilità dell'applicazione definire il byte-endian e l'allineamento dei dati in Valore.

Osservazioni

Nota

L'intestazione wincred.h definisce CREDENTIAL_ATTRIBUTE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	wincred.h