共用方式為


RpcNsProfileEltRemoveA 函式 (rpcnsi.h)

RpcNsProfileEltRemove 函式會從配置檔中移除專案。

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

語法

RPC_STATUS RpcNsProfileEltRemoveA(
  unsigned long ProfileNameSyntax,
  RPC_CSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_CSTR      MemberName
);

參數

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

要移除之配置檔元素中名稱服務專案名稱的指標。

傳回值

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

言論

RpcNsProfileEltRemove 函式會從 ProfileName 專案中的設定檔屬性中移除設定檔專案。 此函式需要與 MemberName 完全相符,並 IfId 參數來移除設定文件專案。 不會刪除專案 (MemberName),包含在配置檔元素中做為成員。

注意:請謹慎使用 RpcNsProfileEltRemove:從配置檔中移除元素可能會有中斷配置檔階層的不必要效果。
 
注意 Windows 2000 Active Directory 支援此函式。 舊版的 Windows NT 僅支援將此函式與 Cell Directory Service (CDS) 搭配使用。
 

注意

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

要求

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

另請參閱

RpcNsProfileDelete

RpcNsProfileEltAdd