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

Vedi anche

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Visualizzare strutture in Active Directory Domain Services