共用方式為

RpcNsGroupMbrInqNextA 函式 （rpcnsi.h）

  • 發行項

RpcNsGroupMbrInqNext 函式一次從群組傳回一個項目名稱。

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

語法

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

參數

InquiryContext

名稱服務句柄。

MemberName

傳回 RPC 組成員名稱指標的位址。 傳回名稱的語法是由 RpcNsGroupMbrInqBegin 函式中的 MemberNameSyntax 參數所指定。

指定 null 值以防止 RpcNsGroupMbrInqNext 傳回 MemberName 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_NS_HANDLE
 名稱服務句柄無效。
RPC_S_NO_MORE_MEMBERS
 沒有其他成員。
RPC_S_NAME_SERVICE_UNAVAILABLE
 無法使用名稱服務。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcNsGroupMbrInqNext 函式會傳回 rpc 群組 RpcNsGroupMbrInqBegin中由 GroupName 參數指定的 RPC 群組成員。 應用程式可以重複呼叫 rpcNsGroupMbrInqNext 來檢視 RPC 群組集的所有成員。 檢視所有群組成員時，此函式會傳回RPC_S_NO_MORE_MEMBERS狀態代碼。 傳回的群組成員未排序。

每次呼叫 RpcNsGroupMbrInqNext 傳回成員名稱時，RPC 運行時間連結庫會為傳回的 MemberName配置記憶體。 應用程式負責針對每個傳回 MemberName 字串呼叫 RpcStringFree。 檢視 RPC 群組的成員之後，應用程式必須呼叫 RpcNsGroupMbrInqDone，才能釋放查詢內容。

針對群組的每個檢視，傳回群組成員的順序可能會不同。 這表示每次執行應用程式時，群組成員傳回至應用程式的順序可能會不同。

注意 Windows 2000 Active Directory 支援此函式。 舊版的 Windows NT 僅支援將此函式與 Cell Directory Service （CDS） 搭配使用。
 

注意

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

要求

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

另請參閱

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree