RpcNsMgmtEntryInqIfIdsA function (rpcnsi.h)
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 RpcNsMgmtEntryInqIfIdsA(
unsigned long EntryNameSyntax,
RPC_CSTR 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.
Note
The rpcnsi.h header defines RpcNsMgmtEntryInqIfIds as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | rpcnsi.h (include Rpc.h) |
Library | Rpcns4.lib |
DLL | Rpcns4.dll |