共用方式為

RpcNsProfileEltRemoveW 函式 （rpcnsi.h）

  • 發行項

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

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

語法

RPC_STATUS RpcNsProfileEltRemoveW(
  unsigned long ProfileNameSyntax,
  RPC_WSTR      ProfileName,
  RPC_IF_ID     *IfId,
  unsigned long MemberNameSyntax,
  RPC_WSTR      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