DeleteBinderyObject

Deletes a bindery object (For cross-platform functionality, see Developing NLMs with Cross-Platform Functions ( NDK: NLM Development Concepts, Tools, and Functions) and call NWDeleteObject )

Local Servers:blocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
Service:Server-Based Bindery

Syntax

   #include <\nlm\nit\nwbindry.h>  
    
   int DeleteBinderyObject (  
      char   *objectName,  
      WORD   objectType); 
   

Parameters

objectName
(IN) Specifies the string containing the name of the bindery object (maximum 48 characters, including the NULL terminator).
objectType
(IN) Specifies the type of the bindery object (OT_USER, OT_GROUP, OT_PRINT_SERVER, and so on).

Return Values

0

(0x00)

ESUCCESS

150

(0x96)

ERR_SERVER_OUT_OF_MEMORY

239

(0xEF)

ERR_INVALID_NAME

240

(0xF0)

ERR_WILDCARD_NOT_ALLOWED

244

(0xF4)

ERR_NO_OBJECT_DELETE_PRIVILEGE

252

(0xFC)

ERR_NO_SUCH_OBJECT

254

(0xFE)

ERR_SERVER_BINDERY_LOCKED

255

(0xFF)

ERR_BINDERY_FAILURE

Remarks

The objectName and objectType parameters must uniquely identify the bindery object to be deleted and must not contain wildcard characters. The objectName can be from 1 to 48 characters long, including the NULL terminator. Only printable characters can be used. Slashes, backslashes, colons, semicolons, commas, asterisks, and question marks are prohibited.

See Also

CreateBinderyObject, RenameBinderyObject

DeleteBinderyObject Example

   #include <stdio.h>  
   #include <\nlm\nit\nwbindry.h>  
    
   main()  
   {  
      int    completionCode;  
      char   objectName[48];  
      WORD   objectType; 
     
      strcpy (objectName, "PROSE");  
      objectType = OT_USER;  
      completionCode = DeleteBinderyObject (objectName, objectType);  
      if (completionCode == 0)  
         printf ("%s  of Type  %d has been deleted\n", objectName, objectType);  
      else  
         printf ("Error %d in DeleteBinderyObject\n", completionCode);  
   }