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

Lihat juga

Gambaran Umum Pertukaran Data Dinamis Jaringan

Struktur DDE Jaringan

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain