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

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Mostrar estructuras en Servicios de dominio de Active Directory