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
Afficher les structures dans services de domaine Active Directory