RpcNsMgmtEntryCreate

The RpcNsMgmtEntryCreate function creates a name-service database entry.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsMgmtEntryCreate( 
  unsigned long  EntryNameSyntax,   
  unsigned char *  EntryName        
);
 

Parameters

EntryNameSyntax
Specifies an integer value that indicates the syntax of the next argument, EntryName.

To use the syntax specified in the registry value HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\
DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.

EntryName
Points to the name of the entry to create.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_INVALID_NAME_SYNTAX Invalid name syntax
RPC_S_UNSUPPORTED_NAME_SYNTAX Unsupported name syntax
RPC_S_INCOMPLETE_NAME Incomplete name
RPC_S_ENTRY_ALREADY_EXISTS Name-service entry already exists
RPC_S_NAME_SERVICE_UNAVAILABLE Name service unavailable

Remarks

Note  The Windows NT 5.0 Active Directory Service supports this function. Support is not available from the Microsoft Locator in earlier versions of NT.

The RpcNsMgmtEntryCreate routine creates an entry in the name-service database.

A management application can call RpcNsMgmtEntryCreate to create a name-service database entry for use by another application that does not itself have the necessary name-service database privileges to create an entry.

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcnsi.h.
  Import Library: Link with rpcns4.lib.

See Also

RpcNsMgmtEntryDelete