Struttura DSDISPLAYSPECOPTIONS (dsclient.h)
La struttura DSDISPLAYSPECOPTIONS viene restituita dal formato degli Appunti di CFSTR_DS_DISPLAY_SPEC_OPTIONS e viene utilizzata per fornire dati a un menu di scelta rapida o a un'estensione della pagina delle proprietà relative agli identificatori di visualizzazione usati. È importante specificare le credenziali richieste dall'estensione per accedere ai dati nel server Active Directory.
Sintassi
typedef struct _DSDISPLAYSPECOPTIONS {
DWORD dwSize;
DWORD dwFlags;
DWORD offsetAttribPrefix;
DWORD offsetUserName;
DWORD offsetPassword;
DWORD offsetServer;
DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;
Members
dwSize
Dimensioni della struttura a scopo di controllo delle versioni.
dwFlags
Set di flag che indicano i dati sull'oggetto e definiscono il contenuto della struttura. Questo può essere zero o una combinazione di uno o più dei valori seguenti.
DSDSOF_HASUSERANDSERVERINFO (0x00000001)
I membri offsetUserName, offsetPassword, offsetServer e offsetServerConfigPath sono validi.
DSDSOF_SIMPLEAUTHENTICATE (0x00000002)
Non specificare ADS_SECURE_AUTHENTICATION flag quando si chiama ADsOpenObject.
DSDSOF_DONTSIGNSEAL (0x00000004)
Non firmare e chiudere quando si aprono oggetti del servizio directory.
DSDSOF_DSAVAILABLE (0x40000000)
Forza il client a evitare di controllare se l'utente è autenticato, la rete è presente o connesso, presupponendo che il client appartenga a un dominio controllato da Active Directory Domain Services.
offsetAttribPrefix
Contiene l'offset, in byte, dall'inizio della struttura DSDISPLAYSPECOPTIONS a una stringa NULL con terminazione NULL che contiene il prefisso dell'identificatore di visualizzazione ottenuto dall'estensione creata. Questa stringa può essere uno dei valori seguenti.
"admin"
L'estensione è stata ottenuta dall'attributo adminPropertyPages .
"shell"
L'estensione è stata ottenuta dall'attributo shellPropertyPages .
Nell'esempio seguente viene illustrato come usare questo membro.
pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos +
pdso->offsetAttribPrefix);
offsetUserName
Contiene l'offset, in byte, dall'inizio della struttura DSDISPLAYSPECOPTIONS a una stringa NULL con terminazione NULL che contiene il nome dell'utente usato per autenticare l'associazione. Questo membro è valido solo se dwFlags contiene il flag di DSDSOF_HASUSERANDSERVERINFO . Se questo membro contiene zero, il nome utente non è incluso.
Nell'esempio seguente viene illustrato come usare questo membro.
pwszUserName = (LPWSTR)((LPBYTE)pdso +
pdso->offsetUserName);
offsetPassword
Contiene l'offset, in byte, dall'inizio della struttura DSDISPLAYSPECOPTIONS a una stringa NULL con terminazione NULL che contiene la password usata per autenticare l'associazione. Questo membro è valido solo se dwFlags contiene il flag di DSDSOF_HASUSERANDSERVERINFO . Se questo membro contiene zero, la password non è inclusa.
Nell'esempio seguente viene illustrato come usare questo membro.
pwszPassword = (LPWSTR)((LPBYTE)pdso +
pdso->offsetPassword);
offsetServer
Contiene l'offset, in byte, dall'inizio della struttura DSDISPLAYSPECOPTIONS a una stringa NULL con terminazione NULL che contiene il nome del server. Questo membro è valido solo se dwFlags contiene il flag di DSDSOF_HASUSERANDSERVERINFO . Se questo membro contiene zero, il nome del server non è incluso.
Nell'esempio seguente viene illustrato come usare questo membro.
pwszServer = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServer);
offsetServerConfigPath
Contiene l'offset, in byte, dall'inizio della struttura DSDISPLAYSPECOPTIONS a una stringa NULL con terminazione NULL, Unicode che contiene l'ADsPath del server. Questo membro è valido solo se dwFlags contiene il flag di DSDSOF_HASUSERANDSERVERINFO . Se questo membro contiene zero, il percorso del server non è incluso.
Nell'esempio seguente viene illustrato come usare questo membro.
pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServerConfigPath);
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | dsclient.h |