NDdeGetTrustedShare 函式
[不再支援網路 DDE。 Nddeapi.dll存在於 Windows Vista 上,但所有函式呼叫都會傳回NDDE_NOT_IMPLEMENTED。]
擷取與伺服器使用者受信任共用清單中 DDE 共用相關聯的選項。
語法
UINT NDdeGetTrustedShare(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_Out_ LPDWORD lpdwTrustOptions,
_Out_ LPDWORD lpdwShareModId0,
_Out_ LPDWORD lpdwShareModId1
);
參數
-
lpszServer [in]
-
DSDM 所在的伺服器名稱。
-
lpszShareName [in]
-
正在查詢其受信任狀態的共用名稱。 此參數不可為 Null。
-
lpdwTrustOptions [out]
-
接收信任選項之變數的指標。 此參數不可為 Null。 下列信任選項可供使用。
值 意義 - NDDE_CMD_SHOW_MASK
- 0x0000FFFFL
如果已設定NDDE_TRUST_CMD_SHOW,用來取得用來覆寫 DDE 共用顯示狀態的值的遮罩。 - NDDE_TRUST_CMD_SHOW
- 0x100000000L
覆寫 DDE 共用 DSDM 中指定的顯示狀態。 - NDDE_TRUST_SHARE_DEL
- 0x20000000L
移除共用的信任狀態。 - NDDE_TRUST_SHARE_INIT
- 0x40000000L
如果用戶端已在使用者的內容中執行,則允許用戶端起始至應用程式。 - NDDE_TRUST_SHARE_START
- 0x80000000L
允許在使用者的內容中啟動應用程式。 -
lpdwShareModId0 [out]
-
接收受信任共用修改識別碼第一個部分之變數的指標。 此參數不可為 Null。
-
lpdwShareModId1 [out]
-
接收受信任共用修改識別碼第二個部分之變數的指標。 此參數不可為 Null。
傳回值
如果函式成功,傳回值會NDDE_NO_ERROR。
如果函式失敗,傳回值是錯誤碼,可藉由呼叫 NDdeGetErrorString轉譯成文字錯誤訊息。
備註
受信任的共用修改識別碼會反映 DSDM 中最初授與信任狀態的 DDE 共用版本。 受信任的共用修改識別碼主要用於移除過時的受信任共用。 不過,使用者不需要移除過時的信任共用。 網路 DDE 代理程式代表使用者移除過時的共用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
標頭 |
|
程式庫 |
|
DLL |
|
Unicode 與 ANSI 名稱 |
NDdeGetTrustedShareW (Unicode) 和 NDdeGetTrustedShareA (ANSI) |