NDDESHAREINFO 結構
[不再支援網路 DDE。 Nddeapi.dll存在於 Windows Vista 上,但所有函式呼叫都會傳回 NDDE_NOT_IMPLEMENTED。
包含 NetDDE Share Database Manager (DSDM) 維護的 DDE 共用屬性。 與每個 DDE 共用相關聯的安全性描述元不會通過這個結構,而是透過特定函式來存取。 NetDDE DSDM API 接受集合函式的這個結構;若是 get 函式,DSDM 會傳回封裝至所提供緩衝區的結構,以及 成員 lpszShareName、 lpszAppTopicList和 lpszItemList所參考的資料。
語法
typedef struct _NDDESHAREINFO {
LONG lRevision;
LPTSTR lpszShareName;
LONG lShareType;
LPTSTR lpszAppTopicList;
LONG fSharedFlag;
LONG fService;
LONG fStartAppFlag;
LONG nCmdShow;
LONG qModifyId[2];
LONG cNumItems;
LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;
成員
-
lRevision
-
NDDESHAREINFO結構的修訂層級。 目前,修訂層級為 1。
-
lpszShareName
-
共用的名稱。 此字串長度不能超過 MAX_NDDESHARENAME 個字元。
-
lShareType
-
一或多個 DDE 共用類型。 這個成員可以是下列支援的 DDE 共用類型組合。
共用類型 意義 - SHARE_TYPE_NEW
- 0x02
共用包含 OLE 應用程式/主題組。 - SHARE_TYPE_OLD
- 0x01
共用包含 DDE 應用程式/主題組。 - SHARE_TYPE_STATIC
- 0x04
共用包含靜態應用程式/主題組。 -
lpszAppTopicList
-
緩衝區的指標,其中包含 DDE、OLE 和靜態應用程式/主題組的 Null 終止字串。 緩衝區的格式應如下:
<DDE application name>|<DDE topic name>\0 <OLE application name>|<OLE topic name>\0 <static application name>|<static topic name>\0\0
-
fSharedFlag
-
如果此成員為 FALSE,DDE 共用將不會允許遠端使用者使用 DDE 進行通訊。 不過,本機使用者仍然可以透過 DDE 共用進行通訊。 如果相關聯的 DACL 授與存取權,則一律會隱含本機用戶端連結。
-
fService
-
如果設定此成員,DDE 共用將不會檢查目前使用者是否在允許 DDE 通訊之前將其設定為受信任。
-
fStartAppFlag
-
如果已設定此成員,且共用信任以啟動應用程式,NetDDE 會在一開始無法啟動與應用程式的 DDE 交談時,嘗試啟動 lpszAppTopicList 所指定的應用程式。
-
nCmdShow
-
當 NetDDE 啟動應用程式以起始 DDE 交談時,此值會透過WinMain函式的nCmdShow參數傳送至應用程式。 它會定義要顯示的應用程式視窗慣用模式。 只有當 fStartAppFlag 為使用中時,此參數才重要。 在應用程式啟動的內容中登入的使用者,也可以在將共用升階為信任狀態時覆寫此選項。 此成員的預設值為 SW_SHOWMAXIMIZED。
-
qModifyId
-
8 位元組序號,表示 DDE 共用的修改序號。 每次 NDdeShareSetInfo 或 NDdeSetShareSecurity 呼叫修改 DDE 共用時,這些值都會變更。
-
cNumItems
-
lpszItemList中列出的專案數目。 如果 cNumItems 為零, 則 lpszItemList 是空的,且共用資訊和相關聯的安全性描述元會套用至相關聯應用程式所服務的所有專案。
-
lpszItemList
-
緩衝區的指標,其中包含以 Null 終止的字串,指定 DDE 交易中用戶端應用程式可以要求或啟動建議迴圈的專案。 如果未列出任何專案,DDE 共用會允許使用任何專案。 清單中的專案數目必須符合 cNumItems 計數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
標頭 |
|