DSDISPLAYSPECOPTIONS 结构 (dsclient.h)

  • 项目

DSDISPLAYSPECOPTIONS 结构由CFSTR_DS_DISPLAY_SPEC_OPTIONS剪贴板格式返回，用于向上下文菜单或属性页扩展提供有关所使用的显示说明符的数据。 必须指定扩展所需的凭据才能访问 Active Directory 服务器中的数据。

语法

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

成员

dwSize

用于版本控制的结构的大小。

dwFlags

一组标志，用于指示有关对象的数据并定义 结构的内容。 这可以是零，也可以是以下一个或多个值的组合。

DSDSOF_HASUSERANDSERVERINFO (0x00000001)

offsetUserName、offsetPassword、offsetServer 和 offsetServerConfigPath 成员有效。

DSDSOF_SIMPLEAUTHENTICATE (0x00000002)

调用 ADsOpenObject 时，不要指定ADS_SECURE_AUTHENTICATION标志。

DSDSOF_DONTSIGNSEAL (0x00000004)

打开目录服务对象时，不要签名和密封。

DSDSOF_DSAVAILABLE (0x40000000)

强制客户端避免检查用户是否已经过身份验证、网络是否存在或已登录，前提是客户端属于由 Active Directory 域服务 控制的域。

offsetAttribPrefix

包含从 DSDISPLAYSPECOPTIONS 结构的开头到以 NULL 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含从中获取所创建扩展的显示说明符的前缀。 此字符串可以是以下值之一。

“admin”

扩展是从 adminPropertyPages 属性获取的。

“shell”

扩展是从 shellPropertyPages 属性获取的。

以下示例演示如何使用此成员。

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

offsetUserName

包含从 DSDISPLAYSPECOPTIONS 结构的开头到以 NULL 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含用于对绑定进行身份验证的用户的名称。 仅当 dwFlags 包含 DSDSOF_HASUSERANDSERVERINFO 标志时，此成员才有效。 如果此成员包含零，则不包括用户名。

以下示例演示如何使用此成员。

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

offsetPassword

包含从 DSDISPLAYSPECOPTIONS 结构的开头到以 NULL 结尾的 Unicode 字符串的偏移量（以字节为单位），该字符串包含用于对绑定进行身份验证的密码。 仅当 dwFlags 包含 DSDSOF_HASUSERANDSERVERINFO 标志时，此成员才有效。 如果此成员包含零，则不包括密码。

以下示例演示如何使用此成员。

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

offsetServer

包含从 DSDISPLAYSPECOPTIONS 结构的开头到包含服务器名称的以 NULL 结尾的 Unicode 字符串的偏移量（以字节为单位）。 仅当 dwFlags 包含 DSDSOF_HASUSERANDSERVERINFO 标志时，此成员才有效。 如果此成员包含零，则不包括服务器名称。

以下示例演示如何使用此成员。

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

offsetServerConfigPath

包含从 DSDISPLAYSPECOPTIONS 结构的开头到包含服务器的 ADsPath 的以 NULL 结尾的 Unicode 字符串的偏移量（以字节为单位）。 仅当 dwFlags 包含 DSDSOF_HASUSERANDSERVERINFO 标志时，此成员才有效。 如果此成员包含零，则不包括服务器路径。

以下示例演示如何使用此成员。

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

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 dsclient.h

请参阅

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

在 Active Directory 域服务 中显示结构