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 網域服務 中顯示結構