Struktur NDDESHAREINFO
[Network DDE tidak lagi didukung. Nddeapi.dll ada pada Windows Vista, tetapi semua panggilan fungsi mengembalikan NDDE_NOT_IMPLEMENTED.]
Berisi atribut berbagi DDE yang dikelola oleh NetDDE Share Database Manager (DSDM). Deskriptor keamanan yang terkait dengan setiap berbagi DDE tidak diteruskan melalui struktur ini tetapi diakses melalui fungsi tertentu. NETDDE DSDM API menerima struktur ini untuk fungsi yang ditetapkan; untuk mendapatkan fungsi, DSDM mengembalikan struktur yang dikemas ke dalam buffer yang disediakan bersama dengan data yang direferensikan oleh anggota lpszShareName, lpszAppTopicList, dan lpszItemList.
Sintaks
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;
Anggota
-
lRevision
-
Tingkat revisi struktur NDDESHAREINFO . Saat ini, tingkat revisi adalah 1.
-
lpszShareName
-
Nama berbagi. Panjang string ini tidak boleh lebih dari MAX_NDDESHARENAME karakter.
-
lShareType
-
Satu atau beberapa jenis berbagi DDE. Anggota ini bisa menjadi kombinasi dari jenis berbagi DDE yang didukung berikut ini.
Jenis berbagi Makna - SHARE_TYPE_NEW
- 0x02
Berbagi berisi pasangan aplikasi/topik OLE. - SHARE_TYPE_OLD
- 0x01
Berbagi berisi pasangan aplikasi/topik DDE. - SHARE_TYPE_STATIC
- 0x04
Berbagi berisi pasangan aplikasi/topik statis. -
lpszAppTopicList
-
Penunjuk ke buffer yang berisi string yang dihentikan null untuk pasangan aplikasi/topik DDE, OLE, dan statis. Buffer harus dalam format berikut:
<DDE application name>|<DDE topic name>\0 <OLE application name>|<OLE topic name>\0 <static application name>|<static topic name>\0\0
-
fSharedFlag
-
Jika anggota ini FALSE, berbagi DDE tidak akan memungkinkan pengguna jarak jauh untuk berkomunikasi melaluinya dengan menggunakan DDE. Namun, pengguna lokal masih dapat berkomunikasi melalui berbagi DDE. Tautan klien lokal selalu tersirat jika DACL terkait memberikan akses.
-
fService
-
Jika anggota ini diatur, berbagi DDE tidak akan memeriksa apakah pengguna saat ini telah mengaturnya sebagai tepercaya sebelum mengizinkan komunikasi DDE.
-
fStartAppFlag
-
Jika anggota ini diatur dan berbagi dipercaya untuk memulai aplikasi, NetDDE akan mencoba memulai aplikasi yang ditentukan oleh lpszAppTopicList jika awalnya tidak dapat memulai percakapan DDE dengan aplikasi.
-
nCmdShow
-
Ketika NetDDE memulai aplikasi untuk memulai percakapan DDE, nilai ini dikirim ke aplikasi melalui parameter nCmdShow dari fungsi WinMain . Ini mendefinisikan mode pilihan untuk jendela aplikasi yang akan ditampilkan. Parameter ini signifikan hanya jika fStartAppFlag aktif. Pengguna yang masuk dalam konteks aplikasi yang dimulai juga dapat mengambil alih opsi ini saat mempromosikan berbagi ke status tepercaya. Default untuk anggota ini adalah SW_SHOWMAXIMIZED.
-
qModifyId
-
Nomor seri 8-byte yang menunjukkan nomor seri modifikasi berbagi DDE. Setiap kali berbagi DDE dimodifikasi oleh panggilan NDdeShareSetInfo atau NDdeSetShareSecurity , nilai-nilai ini diubah.
-
cNumItems
-
Jumlah item yang tercantum dalam lpszItemList. Jika cNumItems nol, maka lpszItemList kosong, dan informasi berbagi dan deskriptor keamanan terkait berlaku untuk semua item yang dilayankan oleh aplikasi terkait.
-
lpszItemList
-
Penunjuk ke buffer yang berisi string yang dihentikan null yang menentukan item aplikasi klien dalam transaksi DDE dapat meminta atau memulai perulangan saran. Jika tidak ada item yang tercantum, berbagi DDE memungkinkan item apa pun untuk digunakan. Jumlah item dalam daftar harus cocok dengan jumlah cNumItems .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|