共用方式為

RpcNsGroupMbrAddA 函式 （rpcnsi.h）

  • 發行項

RpcNsGroupMbrAdd 函式會將專案名稱新增至群組。 如有必要，它會建立專案。

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

語法

RPC_STATUS RpcNsGroupMbrAddA(
  unsigned long GroupNameSyntax,
  RPC_CSTR      GroupName,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

參數

GroupNameSyntax

GroupName語法。

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

GroupName

要接收新成員之 RPC 群組名稱的指標。

MemberNameSyntax

MemberName中使用的語法。

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

MemberName

新 RPC 群組成員名稱的指標。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_NAME_SYNTAX
 名稱語法無效。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 不支援名稱語法。
RPC_S_INCOMPLETE_NAME
 名稱不完整。
RPC_S_NAME_SERVICE_UNAVAILABLE
 無法使用名稱服務。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

RpcNsGroupMbrAdd 會將名稱服務資料庫專案名稱新增為 RPC 群組屬性的成員。

如果 GroupName 專案不存在，RpcNsGroupMbrAdd 嘗試使用群組屬性建立專案，並新增由 MemberName指定的群組成員。 在此情況下，應用程式必須具有建立項目的許可權。 否則，具有必要許可權的管理應用程式應該先呼叫 RpcNsMgmtEntryCreate，再執行應用程式來建立專案。

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

注意

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

要求

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

另請參閱

RpcNsGroupMbrRemove

RpcNsMgmtEntryCreate