RpcNsEntryExpandName  NIDX9B

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.

 

Remarks

 

Note  This DCE function is not supported by the Microsoft Locator version 1.0.

 

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.

Return Values

Value

Meaning

RPC_S_OK

Success

RPC_S_INCOMPLETE_NAME

Incomplete name

 

See Also

RpcStringFree