共用方式為

RpcNsProfileEltAddA 函式 （rpcnsi.h）

  • 發行項

RpcNsProfileEltAdd 函式會將元素新增至配置檔。 如有必要，它會建立專案。

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

語法

RPC_STATUS RpcNsProfileEltAddA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName,
  unsigned long Priority,
  RPC_CSTR      Annotation
);

參數

ProfileNameSyntax

ProfileName語法。

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

ProfileName

要接收新元素之配置檔名稱的指標。

IfId

新配置檔項目的介面識別指標。 若要新增或取代預設配置檔專案，請指定 Null 值。

MemberNameSyntax

MemberName語法。

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

MemberName

要包含在新配置檔專案中的名稱服務專案名稱指標。

Priority

整數值 （0 到 7） 表示在匯入和查閱作業期間使用新設定檔元素的相對優先順序。 值為 0 是最高優先順序;值為 7 是最低優先順序。 新增預設設定文件成員時，請使用 0 的值。

Annotation

儲存為新配置文件專案一部分之批注字串的指標。 如果沒有註釋字串，請指定 Null 值或以 Null 結尾的字串。

字串僅供應用程式用於資訊用途。 例如，應用程式可以使用這個字串來儲存IDL檔案中指定的介面名稱字串。 RPC 不會在查閱或匯入作業期間使用註釋字串，也不會用於列舉配置文件專案。

傳回值

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

言論

RpcNsProfileEltAdd 函式會將專案新增至 ProfileName所指定之 name-service 專案的配置檔屬性。 如果 ProfileName 專案不存在，RpcNsProfileEltAdd 嘗試使用配置文件屬性建立專案，並新增由 IfId、MemberName、Priority和 Annotation 參數所指定的配置文件專案。 在此情況下，應用程式必須具有建立項目的許可權。 否則，具有必要許可權的管理應用程式應該在執行應用程式之前呼叫 RpcNsMgmtEntryCreate 函式來建立專案。

如果配置檔中已經有具有指定成員名稱和介面識別的專案，RpcNsProfileEltAdd 會使用 Priority 和 Annotation 參數中提供的值來更新專案的優先順序和批註字串。

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

注意

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

要求

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

另請參閱

RpcIfInqId

RpcNsMgmtEntryCreate

RpcNsProfileEltRemove