DSDISPLAYSPECOPTIONS-Struktur (dsclient.h)

Die DSDISPLAYSPECOPTIONS-Struktur wird vom CFSTR_DS_DISPLAY_SPEC_OPTIONS Zwischenablageformat zurückgegeben und zum Bereitstellen von Daten an ein Kontextmenü oder eine Eigenschaftenseitenerweiterung über die verwendeten Anzeigespezifizierer verwendet. Es ist wichtig, die Anmeldeinformationen anzugeben, die für die Erweiterung für den Zugriff auf Daten auf dem Active Directory-Server erforderlich sind.

Syntax

typedef struct _DSDISPLAYSPECOPTIONS {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD offsetAttribPrefix;
  DWORD offsetUserName;
  DWORD offsetPassword;
  DWORD offsetServer;
  DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;

Member

dwSize

Die Größe der Struktur zu Versionsverwaltungszwecken.

dwFlags

Ein Satz von Flags, die Daten zum Objekt angeben und den Inhalt der -Struktur definieren. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DSDSOF_HASUSERANDSERVERINFO (0x00000001)

Die Elemente offsetUserName, offsetPassword, offsetServer und offsetServerConfigPath sind gültig.

DSDSOF_SIMPLEAUTHENTICATE (0x00000002)

Geben Sie beim Aufrufen vonADsOpenObject nicht ADS_SECURE_AUTHENTICATION Flag an.

DSDSOF_DONTSIGNSEAL (0x00000004)

Signieren und versiegeln Sie beim Öffnen von Verzeichnisdienstobjekten nicht.

DSDSOF_DSAVAILABLE (0x40000000)

Erzwingt, dass der Client nicht überprüft, ob der Benutzer authentifiziert ist, das Netzwerk vorhanden oder angemeldet ist, vorausgesetzt, der Client gehört zu einer Domäne, die von Active Directory Domain Services gesteuert wird.

offsetAttribPrefix

Enthält den Offset in Bytes vom Anfang der DSDISPLAYSPECOPTIONS-Struktur bis hin zu einer MIT NULL endendten Unicode-Zeichenfolge, die das Präfix des Anzeigespezifizierers enthält, aus dem die erstellte Erweiterung abgerufen wurde. Diese Zeichenfolge kann einer der folgenden Werte sein.

"Administrator"

Die Erweiterung wurde aus dem adminPropertyPages-Attribut abgerufen.

"Shell"

Die Erweiterung wurde aus dem shellPropertyPages-Attribut abgerufen.

Im folgenden Beispiel wird gezeigt, wie Sie diesen Member verwenden.

pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos + 
    pdso->offsetAttribPrefix);

offsetUserName

Enthält den Offset in Bytes vom Anfang der DSDISPLAYSPECOPTIONS-Struktur bis hin zu einer MIT NULL beendeten Unicode-Zeichenfolge, die den Namen des Benutzers enthält, der zum Authentifizieren der Bindung verwendet wird. Dieser Member ist nur gültig, wenn dwFlags das flag DSDSOF_HASUSERANDSERVERINFO enthält. Wenn dieser Member null enthält, ist der Benutzername nicht enthalten.

Im folgenden Beispiel wird gezeigt, wie Sie diesen Member verwenden.

pwszUserName = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetUserName);

offsetPassword

Enthält den Offset in Byte vom Anfang der DSDISPLAYSPECOPTIONS-Struktur bis hin zu einer MIT NULL endenden Unicode-Zeichenfolge, die das Kennwort zum Authentifizieren der Bindung enthält. Dieser Member ist nur gültig, wenn dwFlags das flag DSDSOF_HASUSERANDSERVERINFO enthält. Wenn dieses Element null enthält, ist das Kennwort nicht enthalten.

Im folgenden Beispiel wird gezeigt, wie Sie diesen Member verwenden.

pwszPassword = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetPassword);

offsetServer

Enthält den Offset in Bytes vom Anfang der DSDISPLAYSPECOPTIONS-Struktur bis hin zu einer MIT NULL endendten Unicode-Zeichenfolge, die den Namen des Servers enthält. Dieser Member ist nur gültig, wenn dwFlags das flag DSDSOF_HASUSERANDSERVERINFO enthält. Wenn dieser Member null enthält, ist der Servername nicht enthalten.

Im folgenden Beispiel wird gezeigt, wie Sie diesen Member verwenden.

pwszServer = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServer);

offsetServerConfigPath

Enthält den Offset in Byte vom Anfang der DSDISPLAYSPECOPTIONS-Struktur bis hin zu einer MIT NULL beendeten Unicode-Zeichenfolge, die den ADsPath des Servers enthält. Dieser Member ist nur gültig, wenn dwFlags das flag DSDSOF_HASUSERANDSERVERINFO enthält. Wenn dieser Member null enthält, ist der Serverpfad nicht enthalten.

Im folgenden Beispiel wird gezeigt, wie Sie diesen Member verwenden.

pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso + 
    pdso->offsetServerConfigPath);

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	dsclient.h

Weitere Informationen

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Anzeigestrukturen in Active Directory Domain Services