Fungsi NetShareCheck (lmshare.h)

Artikel
08/24/2023

Memeriksa apakah server berbagi perangkat atau tidak.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetShareCheck(
  [in]  LMSTR   servername,
  [in]  LMSTR   device,
  [out] LPDWORD type
);

Parameter

[in] servername

Penunjuk ke string yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] device

Penunjuk ke string yang menentukan nama perangkat untuk memeriksa akses bersama.

[out] type

Penunjuk ke variabel yang menerima bitmask bendera yang menentukan jenis perangkat bersama. Parameter ini diatur hanya jika fungsi berhasil dikembalikan.

Salah satu bendera berikut dapat ditentukan.

Nilai	Makna
STYPE_DISKTREE	Disk drive.
STYPE_PRINTQ	Cetak antrean.
STYPE_DEVICE	Perangkat komunikasi.
STYPE_IPC	Komunikasi antarproscess (IPC).

Selain itu, salah satu atau kedua bendera berikut dapat ditentukan.

Nilai	Makna
STYPE_SPECIAL	Berbagi khusus disediakan untuk komunikasi antarproscess (IPC$) atau administrasi jarak jauh server (ADMIN$). Dapat juga merujuk ke berbagi administratif seperti C$, D$, E$, dan sebagainya. Untuk informasi selengkapnya, lihat Fungsi Berbagi Jaringan.
STYPE_TEMPORARY	Pembagian sementara.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
ERROR_NOT_ENOUGH_MEMORY	Memori tidak cukup tersedia.
NERR_DeviceNotShared	Perangkat tidak dibagikan.

Keterangan

Fungsi ini hanya berlaku untuk berbagi Blok Pesan Server (SMB). Untuk jenis berbagi lainnya, seperti berbagi Sistem File Terdistribusi (DFS) atau WebDAV, gunakan fungsi Windows Networking (WNet), yang mendukung semua jenis berbagi.

Tidak ada keanggotaan grup khusus yang diperlukan untuk berhasil menjalankan fungsi NetShareCheck .

Jika Anda memprogram Direktori Aktif, Anda mungkin dapat memanggil metode Antarmuka Layanan Direktori Aktif (ADSI) tertentu untuk mencapai fungsionalitas yang sama yang dapat Anda capai dengan memanggil fungsi berbagi manajemen jaringan. Untuk informasi selengkapnya, lihat IADsFileShare.

Contoh

Sampel kode berikut menunjukkan cara memeriksa apakah server berbagi perangkat, menggunakan panggilan ke fungsi NetShareCheck . Fungsi mengembalikan jenis perangkat yang dibagikan, seperti yang dijelaskan dalam dokumentasi sebelumnya untuk parameter jenis .

#ifndef UNICODE
#define UNICODE
#endif
#include <windows.h>
#include <stdio.h>
#include <lm.h>
#pragma comment(lib, "Netapi32.lib")

void wmain( int argc, TCHAR *argv[ ])
{
   NET_API_STATUS res;
   DWORD devType = 0;

   if(argc<3)
      printf("Usage: NetShareCheck server device\n");
   else
   {
      //
      // Call the NetShareCheck function.
      //
      res=NetShareCheck(argv[1], argv[2], &devType);
      //
      // If the function succeeds, inform the user.
      //
      if(res==0)
         printf("Device is shared as type %u.\n",devType);
      //
      // Otherwise, print the error.
      //
      else
         printf("Error: %u\n", res);
   }
   return;
}

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	lmshare.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll