Skip to content

Latest commit

 

History

History
181 lines (142 loc) · 4.77 KB

nf-rpcnsi-rpcnsmgmtentryinqifidsa.md

File metadata and controls

181 lines (142 loc) · 4.77 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:rpcnsi.RpcNsMgmtEntryInqIfIdsA
RpcNsMgmtEntryInqIfIdsA function (rpcnsi.h)
The RpcNsMgmtEntryInqIfIds function returns the list of interfaces exported to a name service�database entry. (ANSI)
RpcNsMgmtEntryInqIfIdsA
rpcnsi/RpcNsMgmtEntryInqIfIdsA
rpc\rpcnsmgmtentryinqifids.htm
Rpc
92f33e1d-a054-4484-903a-c91d3cd549d1
12/05/2018
RpcNsMgmtEntryInqIfIds, RpcNsMgmtEntryInqIfIds function [RPC], RpcNsMgmtEntryInqIfIdsA, RpcNsMgmtEntryInqIfIdsW, _rpc_rpcnsmgmtentryinqifids, rpc.rpcnsmgmtentryinqifids, rpcnsi/RpcNsMgmtEntryInqIfIds, rpcnsi/RpcNsMgmtEntryInqIfIdsA, rpcnsi/RpcNsMgmtEntryInqIfIdsW
rpcnsi.h
Rpc.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
RpcNsMgmtEntryInqIfIdsW (Unicode) and RpcNsMgmtEntryInqIfIdsA (ANSI)
Rpcns4.lib
Rpcns4.dll
Windows
19H1
RpcNsMgmtEntryInqIfIdsA
rpcnsi/RpcNsMgmtEntryInqIfIdsA
c++
APIRef
kbSyntax
DllExport
Rpcns4.dll
RpcNsMgmtEntryInqIfIds
RpcNsMgmtEntryInqIfIdsA
RpcNsMgmtEntryInqIfIdsW

RpcNsMgmtEntryInqIfIdsA function

-description

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.
 

-parameters

-param 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.

-param EntryName

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

-param IfIdVec

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

-returns

Value Meaning
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.

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.

-see-also

RpcIfIdVectorFree

RpcIfInqId

RpcNsBindingExport