Fungsi NDdeShareGetInfo
[Network DDE tidak lagi didukung. Nddeapi.dll ada pada Windows Vista, tetapi semua panggilan fungsi mengembalikan NDDE_NOT_IMPLEMENTED.]
Mengambil informasi berbagi DDE. Ini biasanya dilakukan untuk pengeditan.
Sintaks
UINT NDdeShareGetInfo(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_In_ UINT nLevel,
_Out_ LPBYTE lpBuffer,
_In_ DWORD cBufSize,
_Out_ LPDWORD lpnTotalAvailable,
_In_ LPWORD lpnItems
);
Parameter
-
lpszServer [in]
-
Nama server tempat DSDM berada.
-
lpszShareName [in]
-
Nama berbagi yang informasinya akan diambil dari DSDM. Parameter ini tidak boleh NULL.
-
nLevel [in]
-
Tingkat informasi. Parameter ini harus 2.
-
lpBuffer [keluar]
-
Penunjuk ke buffer yang menerima struktur NDDESHAREINFO dan data terkait yang ditujukan oleh anggotanya. Parameter ini bisa NULL. Jika lpBuffer adalah NULL, maka DSDM menghitung jumlah byte yang diperlukan untuk menyimpan informasi berbagi yang diminta dan mengembalikan nilai tersebut di bidang lpnTotalAvailable bersama dengan kesalahan NDDE_BUF_TOO_SMALL.
-
cBufSize [in]
-
Ukuran buffer lpBuffer , dalam byte. Jika lpBuffer adalah NULL, maka cBufSize harus nol.
-
lpnTotalAvailable [out]
-
Penunjuk ke variabel yang menerima jumlah total byte yang diperlukan untuk menyimpan informasi berbagi yang diminta. Parameter ini tidak boleh NULL.
-
lpnItems [in]
-
Penunjuk ke masker pilihan item untuk pengambilan informasi berbagi parsial.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah NDDE_NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan, yang dapat diterjemahkan ke dalam pesan kesalahan teks dengan memanggil NDdeGetErrorString. Jika parameter lpBufferadalah NULL, parameter tersebut mengembalikan NDDE_BUF_TOO_SMALL.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|
Pustaka |
|
DLL |
|
Nama Unicode dan ANSI |
NDdeShareGetInfoW (Unicode) dan NDdeShareGetInfoA (ANSI) |