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.
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
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The name syntax is invalid. |
|
The name syntax is not supported. |
|
The name is incomplete. |
|
The name-service entry was not found. |
|
The name service is unavailable. |
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 |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
RpcNsMgmtEntryInqIfIdsW (Unicode) and RpcNsMgmtEntryInqIfIdsA (ANSI) |
See also