RpcNsMgmtEntryInqIfIds
The RpcNsMgmtEntryInqIfIds
function returns the list of interfaces exported to a name-service database
entry.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsMgmtEntryInqIfIds(
|
unsigned long EntryNameSyntax, |
|
|
unsigned char * EntryName, |
|
|
RPC_IF_ID_VECTOR * * IfIdVec |
|
|
); |
|
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-service database entry name for which an interface identification vector
is returned.
IfIdVec
Returns a pointer
to a pointer to the interface-identification vector.
Remarks
The RpcNsMgmtEntryInqIfIds
routine returns an interface-identification vector containing the interfaces of
binding handles exported by a server to EntryName.
RpcNsMgmtEntryInqIfIds 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 routine to
release memory used by the vector.
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_NOT_FOUND |
Name-service
entry not found |
|
RPC_S_NAME_SERVICE_UNAVAILABLE |
Name
service unavailable |
See Also