NDdeGetShareSecurity 函式
[不再支援網路 DDE。 Nddeapi.dll存在於 Windows Vista 上,但所有函式呼叫都會傳回 NDDE_NOT_IMPLEMENTED。
擷取與 DDE 共用相關聯的安全性描述元。 這通常是為了編輯而完成。
語法
UINT NDdeGetShareSecurity(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_In_ SECURITY_INFORMATION si,
_Out_ PSECURITY_DESCRIPTOR pSD,
_In_ DWORD cbSD,
_Out_ LPDWORD lpcbsdRequired
);
參數
-
lpszServer [in]
-
DSDM 所在的伺服器名稱。
-
lpszShareName [in]
-
要從 DSDM 擷取其安全性描述元的共用名稱稱。 此參數不可為 Null。
-
si [in]
-
SECURITY_INFORMATION值,指定要從與共享相關聯的安全性描述元擷取的安全性資訊。
-
pSD [out]
-
接收自我相對安全性描述元之 SECURITY_DESCRIPTOR 結構的指標。 此參數可以是 Null。 如果此參數為 Null,DSDM 會決定要求的安全性資訊大小,並傳回 lkbsdRequired 參數中所需的位元組數目,以及NDDE_BUF_TOO_SMALL錯誤碼。
-
cbSD [in]
-
pSD緩衝區的大小。 如果 pSD 為 Null,此參數必須為零。
-
lucsdRequired [out]
-
接收所擷取之安全性描述元之實際大小的變數指標。 此參數不可為 Null。
傳回值
如果函式成功,傳回值會NDDE_NO_ERROR。
如果函式失敗,傳回值為錯誤碼,可藉由呼叫 NDdeGetErrorString轉譯成文字錯誤訊息。 如果 pSD 參數為 Null,則會傳回NDDE_BUF_TOO_SMALL。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
標頭 |
|
程式庫 |
|
DLL |
|
Unicode 與 ANSI 名稱 |
NDdeGetShareSecurityW (Unicode) 和 NDdeGetShareSecurityA (ANSI) |