Структура 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)

Не указывайте флаг ADS_SECURE_AUTHENTICATION при вызове ADsOpenObject.

DSDSOF_DONTSIGNSEAL (0x00000004)

Не подписывайте и не запечатывайте при открытии объектов службы каталогов.

DSDSOF_DSAVAILABLE (0x40000000)

Заставляет клиента избегать проверки подлинности пользователя, наличия сети или входа в систему, при условии, что клиент принадлежит к домену, управляемому доменные службы Active Directory.

offsetAttribPrefix

Содержит смещение в байтах от начала структуры DSDISPLAYSPECOPTIONS до строки Юникода, завершаемой null, которая содержит префикс описателя отображения, из чего было получено созданное расширение. Эта строка может иметь одно из следующих значений.

"admin"

Расширение было получено из атрибута adminPropertyPages .

"оболочка"

Расширение было получено из атрибута shellPropertyPages .

В следующем примере показано, как использовать этот элемент.

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

offsetUserName

Содержит смещение в байтах от начала структуры DSDISPLAYSPECOPTIONS до строки Юникода, завершаемой null, которая содержит имя пользователя, используемого для проверки подлинности привязки. Этот элемент действителен, только если dwFlags содержит флаг DSDSOF_HASUSERANDSERVERINFO . Если этот элемент содержит ноль, имя пользователя не включается.

В следующем примере показано, как использовать этот элемент.

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

offsetPassword

Содержит смещение в байтах от начала структуры DSDISPLAYSPECOPTIONS до строки Юникода, завершаемой null, которая содержит пароль, используемый для проверки подлинности привязки. Этот элемент действителен, только если dwFlags содержит флаг DSDSOF_HASUSERANDSERVERINFO . Если этот элемент содержит ноль, пароль не включается.

В следующем примере показано, как использовать этот элемент.

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

offsetServer

Содержит смещение (в байтах) от начала структуры DSDISPLAYSPECOPTIONS до строки Юникода, завершаемой null, которая содержит имя сервера. Этот элемент действителен, только если dwFlags содержит флаг DSDSOF_HASUSERANDSERVERINFO . Если этот элемент содержит ноль, имя сервера не включается.

В следующем примере показано, как использовать этот элемент.

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

offsetServerConfigPath

Содержит смещение (в байтах) от начала структуры DSDISPLAYSPECOPTIONS до строки Юникода, завершаемой null, которая содержит ADsPath сервера. Этот элемент действителен, только если dwFlags содержит флаг DSDSOF_HASUSERANDSERVERINFO . Если этот элемент содержит ноль, путь к серверу не включается.

В следующем примере показано, как использовать этот элемент.

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

Требования

Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	dsclient.h

См. также раздел

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Отображение структур в доменные службы Active Directory