Estructura DSDISPLAYSPECOPTIONS (dsclient.h)
El formato del Portapapeles CFSTR_DS_DISPLAY_SPEC_OPTIONS devuelve la estructura DSDISPLAYSPECOPTIONS y se usa para proporcionar datos a una extensión de menú contextual o página de propiedades sobre los especificadores de pantalla usados. Es importante especificar las credenciales requeridas por la extensión para acceder a los datos en el servidor de Active Directory.
Sintaxis
typedef struct _DSDISPLAYSPECOPTIONS {
DWORD dwSize;
DWORD dwFlags;
DWORD offsetAttribPrefix;
DWORD offsetUserName;
DWORD offsetPassword;
DWORD offsetServer;
DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;
Miembros
dwSize
Tamaño de la estructura con fines de control de versiones.
dwFlags
Conjunto de marcas que indican datos sobre el objeto y definen el contenido de la estructura. Puede ser cero o una combinación de uno o varios de los valores siguientes.
DSDSOF_HASUSERANDSERVERINFO (0x00000001)
Los miembros offsetUserName, offsetPassword, offsetServer y offsetServerConfigPath son válidos.
DSDSOF_SIMPLEAUTHENTICATE (0x00000002)
No especifique ADS_SECURE_AUTHENTICATION marca al llamar a ADsOpenObject.
DSDSOF_DONTSIGNSEAL (0x00000004)
No firme ni sellar al abrir objetos de servicio de directorio.
DSDSOF_DSAVAILABLE (0x40000000)
Obliga al cliente a evitar comprobar si el usuario está autenticado, la red está presente o ha iniciado sesión, suponiendo que el cliente pertenece a un dominio controlado por Servicios de dominio de Active Directory.
offsetAttribPrefix
Contiene el desplazamiento, en bytes, desde el principio de la estructura DSDISPLAYSPECOPTIONS a una cadena Unicode terminada en NULL que contiene el prefijo del especificador de visualización del que se obtuvo la extensión creada. Esta cadena puede ser uno de los siguientes valores.
"admin"
La extensión se obtuvo del atributo adminPropertyPages .
"shell"
La extensión se obtuvo del atributo shellPropertyPages .
En el ejemplo siguiente se muestra cómo usar este miembro.
pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos +
pdso->offsetAttribPrefix);
offsetUserName
Contiene el desplazamiento, en bytes, desde el inicio de la estructura DSDISPLAYSPECOPTIONS a una cadena Unicode terminada en NULL que contiene el nombre del usuario usado para autenticar el enlace. Este miembro solo es válido si dwFlags contiene la marca DSDSOF_HASUSERANDSERVERINFO . Si este miembro contiene cero, no se incluye el nombre de usuario.
En el ejemplo siguiente se muestra cómo usar este miembro.
pwszUserName = (LPWSTR)((LPBYTE)pdso +
pdso->offsetUserName);
offsetPassword
Contiene el desplazamiento, en bytes, desde el inicio de la estructura DSDISPLAYSPECOPTIONS a una cadena Unicode terminada en NULL que contiene la contraseña utilizada para autenticar el enlace. Este miembro solo es válido si dwFlags contiene la marca DSDSOF_HASUSERANDSERVERINFO . Si este miembro contiene cero, la contraseña no se incluye.
En el ejemplo siguiente se muestra cómo usar este miembro.
pwszPassword = (LPWSTR)((LPBYTE)pdso +
pdso->offsetPassword);
offsetServer
Contiene el desplazamiento, en bytes, desde el inicio de la estructura DSDISPLAYSPECOPTIONS a una cadena Unicode terminada en NULL que contiene el nombre del servidor. Este miembro solo es válido si dwFlags contiene la marca DSDSOF_HASUSERANDSERVERINFO . Si este miembro contiene cero, no se incluye el nombre del servidor.
En el ejemplo siguiente se muestra cómo usar este miembro.
pwszServer = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServer);
offsetServerConfigPath
Contiene el desplazamiento, en bytes, desde el inicio de la estructura DSDISPLAYSPECOPTIONS a una cadena Unicode terminada en NULL que contiene ADsPath del servidor. Este miembro solo es válido si dwFlags contiene la marca DSDSOF_HASUSERANDSERVERINFO . Si este miembro contiene cero, no se incluye la ruta de acceso del servidor.
En el ejemplo siguiente se muestra cómo usar este miembro.
pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServerConfigPath);
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | dsclient.h |
Consulte también
Mostrar estructuras en Servicios de dominio de Active Directory