共用方式為

RpcNsGroupMbrInqBeginW 函式 （rpcnsi.h）

  • 發行項

RpcNsGroupMbrInqBegin 函式會建立查詢內容來檢視群組成員。

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

語法

RPC_STATUS RpcNsGroupMbrInqBeginW(
  unsigned long GroupNameSyntax,
  RPC_WSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_NS_HANDLE *InquiryContext
);

參數

GroupNameSyntax

GroupName語法。

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

GroupName

要檢視之 RPC 群組名稱的指標。

MemberNameSyntax

RpcNsGroupMbrInqNext 函式中，MemberName的傳回參數語法。

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

InquiryContext

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

傳回值

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

言論

RpcNsGroupMbrInqBegin 函式會建立查詢內容，以檢視 RPC 群組的成員。 呼叫 RpcNsGroupMbrInqNext之前，應用程式必須先呼叫 RpcNsGroupMbrInqBegin，才能建立查詢內容。 完成檢視 RPC 群組成員時，應用程式會呼叫 RpcNsGroupMbrInqDone 來刪除查詢內容。

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

注意

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

要求

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

另請參閱

RpcNsGroupMbrAdd

RpcNsGroupMbrInqDone

RpcNsGroupMbrInqNext