Syntax

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

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).

objectID

(OUT) Receives the unique bindery object ID number.

Return Values

Remarks

The objectName and objectType parameters must uniquely identify the bindery object 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

GetBinderyObjectName

GetBinderyObjectID Example

   #include <stdio.h>  
   #include <\nlm\nit\nwbindry.h>  
     
   main()  
   {  
   char  objName[48];  
   WORD  objType;  
   long  objectID;  
   int   completionCode;  
    
     printf ("Enter Object Name:      ");  
     scanf ("%s", objName);  
     printf ("\nEnter Object Type:    ");  
     scanf ("%d", &objType);  
     completionCode = GetBinderyObjectID (objName, objType,  
         &objectID);  
     if (completionCode)  
     {  
         if (completionCode == 150)  
            printf ("SERVER OUT OF MEMORY\n\n");  
         if (completionCode == 239)  
            printf ("INVALID NAME\n\n");  
         if (completionCode == 240)  
            printf ("WILDCARD NOT ALLOWED\n\n");  
         if (completionCode == 252)  
            printf ("NO SUCH OBJECT\n\n");  
         if (completionCode == 254)  
            printf ("SERVER BINDERY LOCKED\n\n");  
         if (completionCode == 255)  
            printf ("BINDERY FAILURE\n\n");  
     }  
     else  
        printf ("\n\nObject ID for %s is...     %8lX\n",  
                 objName, objectID);  
   }