RpcNsEntryObjectInqNext 函式 (rpcnsi.h)

RpcNsEntryObjectInqNext 函式會從名稱服務資料庫專案一次傳回一個物件。

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

語法

RPC_STATUS RpcNsEntryObjectInqNext(
  RPC_NS_HANDLE InquiryContext,
  UUID          *ObjUuid
);

InquiryContext

名稱服務句柄，表示名稱服務資料庫項目的物件 UUID。

ObjUuid

傳回匯出物件 UUID 的指標。

值	意義
RPC_S_OK	呼叫成功。
RPC_S_NO_MORE_MEMBERS	沒有其他成員。
RPC_S_INCOMPLETE_NAME	名稱不完整。
RPC_S_ENTRY_NOT_FOUND	找不到 name-service 專案。
RPC_S_NAME_SERVICE_UNAVAILABLE	無法使用名稱服務。

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

RpcNsEntryObjectInqNext 函式會傳回導出至 RpcNsEntryObjectInqBegin 函式中 EntryName 參數所指定之 name-service 資料庫專案的其中一個物件 UUID。

應用程式可以重複呼叫 RpcNsEntryObjectInqNext 來檢視所有導出的物件 UUID。檢視所有物件 UUID 時，此函式會傳回RPC_S_NO_MORE_MEMBERS狀態代碼。傳回的物件 UUID 未排序。

應用程式會為 ObjUuid 參數中傳回的物件 UUID 提供記憶體。

檢視物件 UUID 之後，應用程式必須呼叫 RpcNsEntryObjectInqDone 函式來釋放查詢內容。

針對每個項目檢視，傳回物件 UUID 的順序可能不同。這表示每次執行應用程式時，物件 UUID 傳回應用程式的順序可能會不同。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	rpcnsi.h (包含 Rpc.h)
程式庫	Rpcns4.lib
Dll	Rpcns4.dll