FS VERIFYUNCNAME

Used to poll installed UNC FSDs to determine server ownership.

Syntax

int far pascal FS_VERIFYUNCNAME(flag, pName)

Parameters

flag

indicates which ‘pass‘ of the poll the FSD is being called.

0x0000 indicates that this is a pass 1 poll.

0x0001 indicates that this is a pass 2 poll.

pName: is a pointer to the ASCIIZ name of the server in UNC format. The FSD does not need to verify this pointer.

Returns

Sample

unsigned short flag;
char far * pName;

int far pascal FS_VERIFYUNCNAME(flag, pName)

Remarks

What the kernel expects from UNC FSDs for this entry point:

For pass 1, the FSD will be called and passed a pointer to the UNC server name. It is to respond immediately if it recognizes (manages) the server with a NO_ERROR return code. This pass expects the that the FSD will be keeping tables in memory that contain the UNC names of the servers it is currently servicing . If the UNC name cannot be validated immediately, the FSD should respond with an error (non-zero) return code. The FSD SHOULD NOT send messages in an attempt to validate the server name.

For pass 2, the FSD is permitted to do whatever is reasonable, including sending LAN ‘are you there‘ messages, to determine if they are able to service the request for UNC server.