RpcNsEntryExpandName

The RpcNsEntryExpandName function expands a name-service entry name.

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

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 entry name to expand.
ExpandedName
Returns a pointer to a pointer to the expanded version of EntryName.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_INCOMPLETE_NAME Incomplete name

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.

An application calls the RpcNsEntryExpandName routine to obtain a fully expanded entry name.

The RPC run-time library allocates memory for the returned ExpandedName argument. The application is responsible for calling the RpcStringFree routine for that returned argument string.

The returned expanded entry name accounts for local name translations and for differences in locally defined naming schemas.

QuickInfo

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

See Also

RpcStringFree