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 [僅限傳統型應用程式]
標頭	Nddeapi.h
程式庫	Nddeapi.lib
DLL	Nddeapi.dll
Unicode 與 ANSI 名稱	NDdeGetShareSecurityW (Unicode) 和 NDdeGetShareSecurityA (ANSI)

另請參閱

網路動態資料交換概觀

網路 DDE 函式

SECURITY_INFORMATION

NDdeSetShareSecurity