Structure DSDISPLAYSPECOPTIONS (dsclient.h)

La structure DSDISPLAYSPECOPTIONS est retournée par le format CFSTR_DS_DISPLAY_SPEC_OPTIONS presse-papiers et est utilisée pour fournir des données à un menu contextuel ou une extension de page de propriétés sur les spécificateurs d’affichage utilisés. Il est important de spécifier les informations d’identification requises par l’extension pour accéder aux données du serveur Active Directory.

Syntaxe

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

Membres

dwSize

Taille de la structure à des fins de contrôle de version.

dwFlags

Ensemble d’indicateurs qui indiquent les données relatives à l’objet et définissent le contenu de la structure. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSDSOF_HASUSERANDSERVERINFO (0x00000001)

Les membres offsetUserName, offsetPassword, offsetServer et offsetServerConfigPath sont valides.

DSDSOF_SIMPLEAUTHENTICATE (0x00000002)

Ne spécifiez pas ADS_SECURE_AUTHENTICATION indicateur lors de l’appel d’ADsOpenObject.

DSDSOF_DONTSIGNSEAL (0x00000004)

Ne signez pas et ne scellez pas lors de l’ouverture d’objets de service d’annuaire.

DSDSOF_DSAVAILABLE (0x40000000)

Force le client à éviter de vérifier si l’utilisateur est authentifié, si le réseau est présent ou connecté, en supposant que le client appartient à un domaine contrôlé par services de domaine Active Directory.

offsetAttribPrefix

Contient le décalage, en octets, entre le début de la structure DSDISPLAYSPECOPTIONS et une chaîne Unicode terminée par NULL qui contient le préfixe du spécificateur d’affichage à partir duquel l’extension créée a été obtenue. Cette chaîne peut être l’une des valeurs suivantes.

« admin »

L’extension a été obtenue à partir de l’attribut adminPropertyPages .

« shell »

L’extension a été obtenue à partir de l’attribut shellPropertyPages .

L’exemple suivant montre comment utiliser ce membre.

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

offsetUserName

Contient le décalage, en octets, entre le début de la structure DSDISPLAYSPECOPTIONS et une chaîne Unicode terminée par NULL qui contient le nom de l’utilisateur utilisé pour authentifier la liaison. Ce membre n’est valide que si dwFlags contient l’indicateur DSDSOF_HASUSERANDSERVERINFO . Si ce membre contient zéro, le nom d’utilisateur n’est pas inclus.

L’exemple suivant montre comment utiliser ce membre.

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

offsetPassword

Contient le décalage, en octets, entre le début de la structure DSDISPLAYSPECOPTIONS et une chaîne Unicode terminée par null qui contient le mot de passe utilisé pour authentifier la liaison. Ce membre n’est valide que si dwFlags contient l’indicateur DSDSOF_HASUSERANDSERVERINFO . Si ce membre contient zéro, le mot de passe n’est pas inclus.

L’exemple suivant montre comment utiliser ce membre.

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

offsetServer

Contient le décalage, en octets, entre le début de la structure DSDISPLAYSPECOPTIONS et une chaîne Unicode terminée par null qui contient le nom du serveur. Ce membre n’est valide que si dwFlags contient l’indicateur DSDSOF_HASUSERANDSERVERINFO . Si ce membre contient zéro, le nom du serveur n’est pas inclus.

L’exemple suivant montre comment utiliser ce membre.

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

offsetServerConfigPath

Contient le décalage, en octets, entre le début de la structure DSDISPLAYSPECOPTIONS et une chaîne Unicode terminée par null qui contient l’ADsPath du serveur. Ce membre n’est valide que si dwFlags contient l’indicateur DSDSOF_HASUSERANDSERVERINFO . Si ce membre contient zéro, le chemin du serveur n’est pas inclus.

L’exemple suivant montre comment utiliser ce membre.

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

Spécifications

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	dsclient.h

Voir aussi

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Afficher les structures dans services de domaine Active Directory