RpcNsEntryObjectInqBeginA 函式（rpcnsi.h）

RpcNsEntryObjectInqBegin 函式會建立名稱服務資料庫專案對象的查詢內容。

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

語法

RPC_STATUS RpcNsEntryObjectInqBeginA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_NS_HANDLE *InquiryContext
);

EntryNameSyntax

EntryName中使用的語法。

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

EntryName

要檢視物件 UUID 之 name-service 資料庫專案名稱的指標。

InquiryContext

傳回名稱服務句柄的指標，以便與 RpcNsEntryObjectInqNext 和 RpcNsEntryObjectInqDone 函式搭配使用。

價值	意義
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 傳回值。

RpcNsEntryObjectInqBegin 函式會建立查詢內容，以檢視導出至 EntryName的物件 UUID。

呼叫 RpcNsEntryObjectInqNext 函式之前，應用程式必須先呼叫 RpcNsEntryObjectInqBegin，才能建立查詢內容。

完成檢視物件 UUID 時，應用程式會呼叫 RpcNsEntryObjectInqDone 函式來刪除查詢內容。

注意

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

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