Previous

Next

Function rtsmb_srv_init_ex

This function initializes the SMB server.

void rtsmb_srv_init_ex(const BYTE * ip, 
                       const BYTE * mask_ip, 
                       const char * net_name, 
                       const char * group_name);

Parameters

ip

Pointer to the IP address of the local host in network byte order.

mask_ip

Net mask of the LAN segment the server is running on.

net_name

NETBIOS name the server will use to identify itself. The name must not be longer than 12 characters.

group_name

NETBIOS name the server will use to identify its work group. The name must not be longer than 12 characters.

rtsmb_srv_init_ex should be the first function of the SMB server API to be called. It reads configuration data from structure CFG_SMBS to which applications can assign non-default values before calling rtsmb_srv_init_ex.

rtsmb_srv_init_ex implicitly creates a special share called "IPC$" which Windows or other SMB clients need to enable browsing the shares published by a server. In addition, the following functions are called implicitly:

rtsmb_srv_set_group_permissions_ex("Guests", "IPC$", SMB_SECURITY_READ); 
rtsmb_srv_register_user_ex("Guests", "", NULL);

A default user which SMB clients can use to browse the published shares is created. If you prefer that no shares are browsable, applications can call rtsmb_srv_set_group_permissions_ex again on group "Guests" to set permission to SMB_SECURITY_NONE.

SMB Server

Configuration

Function rtsmb_srv_share_add_tree_ex