Export (0) Print
Expand All
Expand Minimize

RpcNsMgmtEntryInqIfIds function

The RpcNsMgmtEntryInqIfIds function returns the list of interfaces exported to a name service–database entry. It also returns an interface-identification vector containing the interfaces of binding handles exported by a server to EntryName. This function uses an expiration age of 0, causing an immediate update of the local copy of name-service data.

Note  This function is not supported on Windows Vista and later operating systems.

Syntax


RPC_STATUS RPC_ENTRY RpcNsMgmtEntryInqIfIds(
  unsigned long EntryNameSyntax,
  unsigned char *EntryName,
  RPC_IF_ID_VECTOR **IfIdVec
);

Parameters

EntryNameSyntax

Syntax of EntryName.

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

EntryName

Pointer to the name service–database entry name for which an interface-identification vector is returned.

IfIdVec

Returns an address of a pointer to the interface-identification vector.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_INVALID_NAME_SYNTAX

The name syntax is invalid.

RPC_S_UNSUPPORTED_NAME_SYNTAX

The name syntax is not supported.

RPC_S_INCOMPLETE_NAME

The name is incomplete.

RPC_S_ENTRY_NOT_FOUND

The name-service entry was not found.

RPC_S_NAME_SERVICE_UNAVAILABLE

The name service is unavailable.

 

Note  For a list of valid error codes, see RPC Return Values.

Remarks

The RpcNsMgmtEntryInqIfIds function returns an interface-identification vector containing the interfaces of binding handles exported by a server to EntryName. This function uses an expiration age of 0, causing an immediate update of the local copy of name-service data. The calling application is responsible for calling the RpcIfIdVectorFree function to release memory used by the vector.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcnsi.h (include Rpc.h)

Library

Rpcns4.lib

DLL

Rpcns4.dll

Unicode and ANSI names

RpcNsMgmtEntryInqIfIdsW (Unicode) and RpcNsMgmtEntryInqIfIdsA (ANSI)

See also

RpcIfIdVectorFree
RpcIfInqId
RpcNsBindingExport

 

 

Community Additions

ADD
Show:
© 2014 Microsoft