共用方式為

RpcNsMgmtEntryDeleteA 函式 （rpcnsi.h）

  • 發行項

RpcNsMgmtEntryDelete 函式會刪除名稱 service-database 專案。

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

語法

RPC_STATUS RpcNsMgmtEntryDeleteA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName
);

參數

EntryNameSyntax

EntryName的語法。

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

EntryName

要刪除之專案名稱的指標。

傳回值

價值 意義
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_S_NOT_RPC_ENTRY
 不是 RPC 專案。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

管理應用程式只有在不再需要專案時才使用 RpcNsMgmtEntryDelete 函式，例如，當伺服器從服務中永久移除時。

因為 name-service 資料庫的設計目的是要相對穩定，所以經常在用戶端或伺服器應用程式中使用 RpcNsMgmtEntryDelete 可能會導致效能問題。 在用戶端或伺服器應用程式中建立和刪除專案會導致 name-service 資料庫重複移除並取代相同的專案。 這可能會導致復寫名稱服務資料庫中的效能問題。

注意

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

要求

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

另請參閱

RpcNsMgmtEntryCreate