RpcNsMgmtEntryInqIfIdsA 函式（rpcnsi.h）

RpcNsMgmtEntryInqIfIds 函式會傳回導出至名稱服務資料庫專案的介面清單。它也會傳回介面識別向量，其中包含伺服器所匯出之系結句柄的介面，EntryName。此函式會使用 0 的到期期限，導致立即更新名稱服務數據的本機複本。

注意 Windows Vista 和更新版本的作業系統不支援此函式。

語法

RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
  unsigned long    EntryNameSyntax,
  RPC_CSTR         EntryName,
  RPC_IF_ID_VECTOR **IfIdVec
);

EntryNameSyntax

EntryName的語法。

若要使用登錄值專案中指定的語法 HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax，請提供 RPC_C_NS_SYNTAX_DEFAULT 的值。

EntryName

傳回介面識別向量的名稱服務資料庫專案名稱指標。

IfIdVec

傳回介面識別向量的指標位址。

價值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_NAME_SYNTAX	名稱語法無效。
RPC_S_UNSUPPORTED_NAME_SYNTAX	不支援名稱語法。
RPC_S_INCOMPLETE_NAME	名稱不完整。
RPC_S_ENTRY_NOT_FOUND	找不到名稱服務專案。
RPC_S_NAME_SERVICE_UNAVAILABLE	無法使用名稱服務。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

RpcNsMgmtEntryInqIfIds 函式會傳回介面識別向量，其中包含伺服器導出至 EntryName之系結句柄的介面。此函式會使用 0 的到期期限，導致立即更新名稱服務數據的本機複本。呼叫應用程式負責呼叫 RpcIfIdVectorFree 函式來釋放向量所使用的記憶體。

注意

rpcnsi.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcNsMgmtEntryInqIfIds 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	rpcnsi.h （包括 Rpc.h）
連結庫	Rpcns4.lib
DLL	Rpcns4.dll